GateData.AI

Crypto asset treasuries

Query corporate and government crypto reserves, totals, and holder details.

GET/api/v1/treasury
Domain
Flows & Wallets
Level
asset-level
MCP tool
ownership_flows_query (task=treasuries)

Available data

Query level: asset-level.

  • Provide at least one of asset_id, symbol, ticker, base or query; multiple filters intersect.

    Authentication

    Send Authorization: Bearer YOUR_API_KEY or X-API-KEY on every request.

    Query Parameters

    Asset identification and filters

    Provide at least one of asset_id, symbol, ticker, base or query; multiple filters intersect.

    asset_idstringqueryExampleasset_btcconditional

    Unique asset ID.

    symbolstringqueryExampleBTCconditional

    Asset symbol; exact case-insensitive match.

    tickerstringqueryExampleBTCconditional

    Crypto asset ticker, not an ETF ticker.

    basestringqueryExampleBTCconditional

    Canonical base asset; exact case-insensitive match.

    querystringqueryExampleBTCconditional

    Asset name, symbol or alias.

    Response

    data[]object[]

    Asset treasury rows; empty when unmatched.

    asset_idstringExampleasset_btc

    Resolved asset ID.

    symbolstringExampleBTC

    Asset symbol.

    asset_namestringExampleBitcoin

    Asset name.

    total_holdingsnumberExample1924573

    Total units held by companies and governments.

    total_value_usdnumberExample160510000000

    Current total holdings value in USD.

    holders[]object[]

    Holders sorted by current USD value descending.

    namestringExampleStrategy

    Company or government name.

    entity_typestringExamplecompany

    Holder type: company or government.

    symbolstring | nullExampleMSTR.US

    Listed company ticker; null for governments.

    countrystring | nullExampleUS

    Country or region code; nullable.

    total_holdingsnumberExample848250

    Asset units held by this entity.

    total_current_value_usdnumberExample70552429000

    Current value of this holder’s assets in USD.

    data_statusDataStatusExampleok

    Data status: ok or no_data.

    empty_reasonstring | null

    No-data reason; null when data exists.

    errorobject | null

    Error object; null on success.

    lineage_refsobject[]

    Lineage references; usually empty in public responses.

    resolution_statusResolutionStatusExampleresolved

    Asset resolution status, e.g. resolved or ambiguous.

    source_refsobject[]

    Source references; empty when none are public.

    metadataobject

    Request routing, domain bindings and object references.

    actual_taskstringExampletreasury

    Executed task; fixed to treasury.

    route_reasonstringExampleexplicit_task

    explicit_task for direct requests.

    domain_bindingsobject

    Domain bindings; empty when none apply.

    object_refs[]object[]

    Unified object references.

    typeObjectRefTypeExampleasset

    Object type, e.g. asset or entity.

    idstringExampleasset_btc

    Unified object ID.

    Errors & fallback

    200
    No matching asset or treasury data; data=[] and data_status=no_data.
    400
    Missing asset identification, invalid parameters or ambiguous resolution.
    401
    API Key is missing or invalid.
    403
    API Key does not have access.
    429
    Request rate limit exceeded.