Transactions Guide

The Transactions endpoint returns a comprehensive, normalized list of a user's digital asset transactions across multiple sources, including exchanges, custodial platforms, and self-custodial wallets. Transaction data can be complex due to variations in formats, metadata, and transaction types (e.g., trades, transfers, staking rewards, gas fees). This endpoint normalizes data and presents a unified, structured view of all activity, including timestamps, asset types, amounts, sources, and transaction categories.

Use Case

Ideal for applications that need to display transaction history, generate tax reports, or analyze user behavior. For example, if a user:

Bought 0.1 BTC on Coinbase
Transferred 0.05 BTC to a self-custodial wallet
Received 0.01 BTC as a reward

Download OpenAPI Spec

Transactions endpoint

Get transactions

Get transactions from all or specific exchanges for the connected user.

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

Authorization

This endpoint requires a bearer token in the header.

Example

curl --request GET \
  --url 'https://api.getcalico.com/platform/v1/transactions \
  --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 results to include only transactions with the specified asset symbol(s). Multiple symbols can be provided as a comma-separated list. Leaving this parameter blank defaults to including all assets. Example: `/transactions?asset_symbols=BTC,SOL` Returns only BTC and SOL transactions.
`crypto_sources`	string	Filters results to include only transactions 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: `/transactions?crypto_sources=coinbase,binance` Returns only Coinbase and Binance transactions.
`limit`	number	Maximum number of transactions to return. If not specified, the value defaults to 30. The maximum value is 100.

Example response

[
  {
    "crypto_source_transaction_id": "{{exampleId}}",
    "hashed_txn": "{{exampleHashedTxn}}",
    "timestamp": "1758233358000",
    "crypto_source_id": "bitcoin",
    "wallet_address_redacted": "0wlh",
    "transaction_type": "RECEIVE",
    "fee": {
      "itemized_receipt": [
        {
          "source": "NETWORK",
          "value": "0.00000142",
          "currency": "BTC"
        }
      ]
    },
    "output": {
      "value": "0.00457988",
      "currency": "BTC",
      "asset_type": "COIN"
    }
  }
]

Ready to get started?

Assets Guide

Reference