Skip to main content

Overview

The MARCO API is RESTful interface designed for developers to integrate MARCO into their applications and services. This documentation provides an understanding of the HTTP requests, endpoints, and additional guides.

HTTP requests​

Most endpoints are protected using Bearer Authentication.

Before you start making API calls, you need two tokens:

  • AccessToken: A token issued from the /v1/auth/token endpoint. Generate one with Key File or API Key.
  • ApplicationToken: A token that is associated with the Marpp. To create one, see Generate an API Key
tip

For a step-by-step tutorial to retrieve the necessary access and application tokens, refer to our Quickstart.

With the tokens in hand, you are set to authenticate your API requests. For instance, if you are aiming to access the GET /v1/sample-endpoint, ensure your request includes the headers as shown below:

curl --location --request GET 'https://api-marco.finboot.com/v1/sample-endpoint' \
--header 'Accept: application/json' \
--header 'ApplicationToken: <APPLICATION_TOKEN>'\
--header 'Authorization: Bearer <ACCESS_TOKEN>'

By following this authentication method, you can securely and effectively communicate with MARCO's API endpoints.

Endpoints​

MARCO API is organized into the following collections:

card iconcard icon

Authentication

Authentication endpoints

card iconcard icon

Ledger ops

Ledger ops endpoints

card iconcard icon

Smart contracts

Smart contracts endpoints