ARarbital
Product Market

GET /v2/market/tokens/{chain_id}/{address}/holders

Returns a bounded, display-only Mobula top-holder snapshot enriched from permitted public CALLD, FOMO, and Pump identities. Known pools, contracts, and lockers are excluded; unclassified addresses remain visible and are not verified human wallets. Arc remains outside the existing chain allowlist. Buy/sell counts are provider totals; P&L is a provider gross estimate with fees excluded. Holder facts are request-time observations and are never portfolio, quote, or execution authority.

Request

  • Base URL
    https://api.arbital.xyz (the document declares no server; this is the origin it was published from)
  • URL
    https://api.arbital.xyz/v2/market/tokens/{chain_id}/{address}/holders
  • Auth
    HTTP bearer

Path parameters

chain_id'solana:mainnet-beta' | 'eip155:1' | 'eip155:56' | 'eip155:4663' | 'eip155:8453' required
addressstring required

Query parameters

limitinteger

Maximum rows to return from the filtered provider window, including unclassified addresses. Defaults to 100.

cursorstring

Opaque continuation cursor returned by the previous page and bound to that provider snapshot. A 409 response means the snapshot changed and pagination must restart.

Response

Current holder facts plus available public platform identity matches

enrichment_status'available' | 'unavailable' required
freshness'fresh' | 'stale' required
next_cursorstring nullable required
observed_at_msstring required
percentage_basis'total_supply' required

Changes

No recorded changes to this operation across all 1 revision of this API.