The Aggregator Suite API uses a JSON Web Token to secure all data requests. Each one of the requests needs to contain the JWT which has an expiration of 30 minutes and needs to be refreshed after that period of time.
To request a JWT it is necessary to make a GET request to api.zenledger.io/oauth/token with the credentials previously facilitated by ZenLedger.
This same resource will be used to refresh the token after expiration.

Here is an example in javascript of how to request a JWT:

const clientId = 'provided_client_id';
const clientSecret = 'provided_secret';
const tokenEndpoint = 'https://api.zenledger.io/oauth/token';
const requestOptions = {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    client_id: clientId,
    client_secret: clientSecret,
    grant_type: 'client_credentials',
  }),
};
fetch(tokenEndpoint, requestOptions)
  .then((response) => {
    if (!response.ok) {
      throw new Error('Failed to obtain JWT token');
    }
    return response.json();
  })
  .then((data) => {
    const token = data.access_token;
    console.log('JWT Token:', token);
    // You can now use the token for further requests.
  })
  .catch((error) => {
    console.error('Error:', error);
  });

Once the JWT is created you can use it for every other request to the API:

const jwtToken = 'your-jwt-token';
const apiUrl = 'https://api.zenledger.io/aggregators/api/v1/sources';
fetch(apiUrl, {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json'
    'Authorization': 'Bearer ${jwtToken}''
  }
})
  .then(response => response.json())
  .then(response_data => {
    // Handle the response data (list of sources)
    console.log('source list:', response_data.data);
  })
  .catch(error => {
    // Handle any errors
    console.error('Error:', error);
  });

The Portfolios API resource allows to create wallet portfolios.

1. Create Portfolio Endpoint: This POST endpoint allows for the creation of new portfolios, requiring authentication via a bearer token.

These endpoints form the basis of portfolio data management in the application, adhering to standard HTTP protocols and returning appropriate status codes based on the request’s success or failure.

The Taxes API resource allows to retrieve tax summary.

1. GET Taxes Endpoint: This GET endpoint allows for retrieval of tax summary, requiring authentication via a bearer token.

These endpoints form the basis of tax summary reports, adhering to standard HTTP protocols and returning appropriate status codes based on the request’s success or failure.

The sources resource in the Aggregators API provides information about retrieving the list of supported wallet providers. By making a GET request to the /aggregators/api/v1/sources endpoint, you can retrieve the details of available sources. The request requires authentication using a bearer token.

Please note that the response example for this endpoint will contain the API version and a data object containing an array of sources. Each currency object includes a reference, name, type and other useful attributes.

Use this information to integrate and work with the supported sources of the Aggregators API.

The currencies resource in the Aggregators API provides information about retrieving the list of supported currencies. By making a GET request to the /aggregators/api/v1/currencies endpoint, you can retrieve the details of available currencies. The request requires authentication using a bearer token.

Please note that the response example for this endpoint will contain the API version and a data object containing an array of currencies. Each currency object includes a reference, code, and name.

Use this information to integrate and work with the supported currencies of the Aggregators Suite API.

The Aggregators API includes specific error codes to indicate and describe various issues and errors that may occur during API interactions. To help you quickly identify and understand these error codes, we have provided a glossary below. This table contains commonly encountered error codes along with their corresponding meanings. Refer to this table for efficient troubleshooting when working with our Aggregators API.