v1

latestOpenAPI 3.1.02026-07-2681217214.1 KB
HOLDINGS
DEVELOPER
WALLET

Get Holdings History

post/api/v1/developer/wallet/holdings/history

Query parameters

cursorstring
min_liquiditynumber

Minimum USD liquidity threshold to include a token

Minimum USD liquidity threshold to include a token

Request body

start_timestampstring date-time required

Start of time range (UTC ISO 8601)

end_timestampstring date-time required

End of time range (UTC ISO 8601)

granularity'15s' | '1m' | '5m' | '1h' | '1d' required
include_token_breakdownboolean

If true, includes per-token breakdown in each interval

Example request

{
  "addresses": [
    {
      "address": "125Z6k4ZAxsgdG7JxrKZpwbcS1rxqpAeqM9GSCKd66Wp",
      "chain": "solana"
    }
  ],
  "end_timestamp": "2025-04-10T00:00:00Z",
  "granularity": "1h",
  "include_token_breakdown": false,
  "start_timestamp": "2025-04-01T00:00:00Z"
}

Response

Successful Response

cursorstring nullable

Pagination cursor for next page

Example response

{
  "items": [
    {
      "address": "0x8e0e6fbaf18f209916bb7c5960a70d6bb5760938",
      "amount": {
        "amount": 297231.67,
        "currency": "USD"
      },
      "chain": "ethereum",
      "timestamp": "2026-04-12T00:00:00Z"
    },
    {
      "address": "0x8e0e6fbaf18f209916bb7c5960a70d6bb5760938",
      "amount": {
        "amount": 305582.84,
        "currency": "USD"
      },
      "chain": "ethereum",
      "timestamp": "2026-04-11T00:00:00Z"
    },
    {
      "address": "0x8e0e6fbaf18f209916bb7c5960a70d6bb5760938",
      "amount": {
        "amount": 310573.28,
        "currency": "USD"
      },
      "chain": "ethereum",
      "timestamp": "2026-04-10T00:00:00Z"
    }
  ]
}