Assets Guide

The Assets endpoint returns a consolidated view of a user's digital asset balances across multiple sources, such as exchanges, custodial platforms, and self-custodial wallets. This endpoint simplifies portfolio tracking by aggregating balances into a single response, eliminating the need to query each source individually.

Use Case

Ideal for applications that need to display a user's total holdings across various platforms. For example, if a user holds:

BTC  on Coinbase
BTC  in a self-custodial wallet

OpenAPI

The Calico OpenAPI Specification (OAS) includes all endpoints plus request & response schemas with definitions. Use it for reference or to generate collections or SDKs.

Learn more about:

→ OpenAPI

→ OpenAPI codegen

Download Calico OAS

Assets endpoint

Get assets for user

Get assets from all exchanges associated with the connected user.

https://api.getcalico.com/platform/v1/assets

Authorization

This endpoint requires a bearer token in the header.

Example

curl --request GET \
  --url https://api.getcalico.com/platform/v1/assets \
  --header 'Authorization: Bearer <token>'

Parameters

The following query parameters are optional.

Parameter	Type	Description
`start_time`	number	Request data fetched after this time. Format timestamps in milliseconds since the Unix epoch. `start_time` must not be later than `end_time`.
`end_time`	number	Request data fetched before this time. Format timestamps in milliseconds since the Unix epoch. `end_time` must not be before `start_time`.
`asset_symbols`	string	Filters to return only assets with the specified asset symbol(s). Multiple symbols can be provided as a comma-separated list. Omitting this parameter defaults to all assets. Example: `/assets?asset_symbols=BTC,SOL` Returns only BTC and SOL assets.
`crypto_sources`	string	Filters results to include only assets from the specified crypto_source(s). Multiple sources can be provided as a comma-separated list. Leaving this parameter blank defaults to querying all connected crypto sources. Example: `/assets?crypto_sources=coinbase,binance` Returns only Coinbase and Binance assets.
`limit`	number	Maximum number of assets to return. If not specified, the value defaults to 30. The maximum value is 100.

Example response

{
  "data": [
    {
      "asset_symbol": "USDC",
      "asset_holdings": 206.651753,
      "price_in_usd": 206.59355189175383,
      "staked_holdings": 0,
      "time_fetched": "2025-09-26T14:17:39.584Z",
      "crypto_source_id": "ethereum",
      "wallet_address_redacted": "96Fc"
    },
    {
      "asset_symbol": "ETH",
      "asset_holdings": 0.01560091360042268,
      "price_in_usd": 61.016837497724595,
      "staked_holdings": 0,
      "time_fetched": "2025-09-26T14:17:39.584Z",
      "crypto_source_id": "ethereum",
      "wallet_address_redacted": "96Fc"
    }
  ],
  "errors": []
}

Ready to get started?

Authentication

Transactions Guide