{"openapi":"3.1.0","info":{"title":"asset-holdings Subgraph API","version":"1.0.0","description":"Per-holder balances across FT (incl. sBTC) + STX (USD-rankable TVL source)"},"servers":[{"url":"https://api.secondlayer.tools"}],"paths":{"/v1/subgraphs/asset-holdings/holdings":{"get":{"summary":"Query asset-holdings.holdings","operationId":"query_asset_holdings_holdings","parameters":[{"name":"_limit","in":"query","required":false,"description":"Maximum rows to return.","schema":{"type":"integer","default":50,"minimum":1,"maximum":1000}},{"name":"cursor","in":"query","required":false,"description":"Resume token from next_cursor (keyset pagination on _id).","schema":{"type":"string"}},{"name":"_order","in":"query","required":false,"description":"Sort direction (_id keyset).","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}},{"name":"_fields","in":"query","required":false,"description":"Comma-separated columns to include.","schema":{"type":"string"}},{"name":"_search","in":"query","required":false,"description":"Search across searchable columns.","schema":{"type":"string"}},{"name":"kind","in":"query","required":false,"description":"Filter kind by equality.","schema":{"type":"string"}},{"name":"kind.neq","in":"query","required":false,"description":"Filter kind by inequality.","schema":{"type":"string"}},{"name":"kind.like","in":"query","required":false,"description":"Case-insensitive contains filter for kind.","schema":{"type":"string"}},{"name":"amount","in":"query","required":false,"description":"Filter amount by equality.","schema":{"type":"string"}},{"name":"amount.neq","in":"query","required":false,"description":"Filter amount by inequality.","schema":{"type":"string"}},{"name":"amount.gt","in":"query","required":false,"description":"Filter amount with gt.","schema":{"type":"string"}},{"name":"amount.gte","in":"query","required":false,"description":"Filter amount with gte.","schema":{"type":"string"}},{"name":"amount.lt","in":"query","required":false,"description":"Filter amount with lt.","schema":{"type":"string"}},{"name":"amount.lte","in":"query","required":false,"description":"Filter amount with lte.","schema":{"type":"string"}},{"name":"holder","in":"query","required":false,"description":"Filter holder by equality.","schema":{"type":"string"}},{"name":"holder.neq","in":"query","required":false,"description":"Filter holder by inequality.","schema":{"type":"string"}},{"name":"holder.like","in":"query","required":false,"description":"Case-insensitive contains filter for holder.","schema":{"type":"string"}},{"name":"asset_identifier","in":"query","required":false,"description":"Filter asset_identifier by equality.","schema":{"type":"string"}},{"name":"asset_identifier.neq","in":"query","required":false,"description":"Filter asset_identifier by inequality.","schema":{"type":"string"}},{"name":"asset_identifier.like","in":"query","required":false,"description":"Case-insensitive contains filter for asset_identifier.","schema":{"type":"string"}},{"name":"_id","in":"query","required":false,"description":"Filter _id by equality.","schema":{"type":"string"}},{"name":"_id.neq","in":"query","required":false,"description":"Filter _id by inequality.","schema":{"type":"string"}},{"name":"_id.gt","in":"query","required":false,"description":"Filter _id with gt.","schema":{"type":"string"}},{"name":"_id.gte","in":"query","required":false,"description":"Filter _id with gte.","schema":{"type":"string"}},{"name":"_id.lt","in":"query","required":false,"description":"Filter _id with lt.","schema":{"type":"string"}},{"name":"_id.lte","in":"query","required":false,"description":"Filter _id with lte.","schema":{"type":"string"}},{"name":"_block_height","in":"query","required":false,"description":"Filter _block_height by equality.","schema":{"type":"string"}},{"name":"_block_height.neq","in":"query","required":false,"description":"Filter _block_height by inequality.","schema":{"type":"string"}},{"name":"_block_height.gt","in":"query","required":false,"description":"Filter _block_height with gt.","schema":{"type":"string"}},{"name":"_block_height.gte","in":"query","required":false,"description":"Filter _block_height with gte.","schema":{"type":"string"}},{"name":"_block_height.lt","in":"query","required":false,"description":"Filter _block_height with lt.","schema":{"type":"string"}},{"name":"_block_height.lte","in":"query","required":false,"description":"Filter _block_height with lte.","schema":{"type":"string"}},{"name":"_tx_id","in":"query","required":false,"description":"Filter _tx_id by equality.","schema":{"type":"string"}},{"name":"_tx_id.neq","in":"query","required":false,"description":"Filter _tx_id by inequality.","schema":{"type":"string"}},{"name":"_tx_id.like","in":"query","required":false,"description":"Case-insensitive contains filter for _tx_id.","schema":{"type":"string"}},{"name":"_created_at","in":"query","required":false,"description":"Filter _created_at by equality.","schema":{"type":"string"}},{"name":"_created_at.neq","in":"query","required":false,"description":"Filter _created_at by inequality.","schema":{"type":"string"}},{"name":"_created_at.gt","in":"query","required":false,"description":"Filter _created_at with gt.","schema":{"type":"string"}},{"name":"_created_at.gte","in":"query","required":false,"description":"Filter _created_at with gte.","schema":{"type":"string"}},{"name":"_created_at.lt","in":"query","required":false,"description":"Filter _created_at with lt.","schema":{"type":"string"}},{"name":"_created_at.lte","in":"query","required":false,"description":"Filter _created_at with lte.","schema":{"type":"string"}},{"name":"_created_at.like","in":"query","required":false,"description":"Case-insensitive contains filter for _created_at.","schema":{"type":"string"}}],"responses":{"200":{"description":"Rows returned from the subgraph table.","content":{"application/json":{"schema":{"type":"object","properties":{"rows":{"type":"array","items":{"$ref":"#/components/schemas/holdingsRow"}},"next_cursor":{"type":["string","null"]},"tip":{"type":"object","properties":{"block_height":{"type":"integer"},"subgraph_height":{"type":"integer"},"blocks_behind":{"type":"integer"}}}}}}}}}}},"/v1/subgraphs/asset-holdings/holdings/count":{"get":{"summary":"Count asset-holdings.holdings","operationId":"count_asset_holdings_holdings","parameters":[{"name":"_limit","in":"query","required":false,"description":"Maximum rows to return.","schema":{"type":"integer","default":50,"minimum":1,"maximum":1000}},{"name":"cursor","in":"query","required":false,"description":"Resume token from next_cursor (keyset pagination on _id).","schema":{"type":"string"}},{"name":"_order","in":"query","required":false,"description":"Sort direction (_id keyset).","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}},{"name":"_fields","in":"query","required":false,"description":"Comma-separated columns to include.","schema":{"type":"string"}},{"name":"_search","in":"query","required":false,"description":"Search across searchable columns.","schema":{"type":"string"}},{"name":"kind","in":"query","required":false,"description":"Filter kind by equality.","schema":{"type":"string"}},{"name":"kind.neq","in":"query","required":false,"description":"Filter kind by inequality.","schema":{"type":"string"}},{"name":"kind.like","in":"query","required":false,"description":"Case-insensitive contains filter for kind.","schema":{"type":"string"}},{"name":"amount","in":"query","required":false,"description":"Filter amount by equality.","schema":{"type":"string"}},{"name":"amount.neq","in":"query","required":false,"description":"Filter amount by inequality.","schema":{"type":"string"}},{"name":"amount.gt","in":"query","required":false,"description":"Filter amount with gt.","schema":{"type":"string"}},{"name":"amount.gte","in":"query","required":false,"description":"Filter amount with gte.","schema":{"type":"string"}},{"name":"amount.lt","in":"query","required":false,"description":"Filter amount with lt.","schema":{"type":"string"}},{"name":"amount.lte","in":"query","required":false,"description":"Filter amount with lte.","schema":{"type":"string"}},{"name":"holder","in":"query","required":false,"description":"Filter holder by equality.","schema":{"type":"string"}},{"name":"holder.neq","in":"query","required":false,"description":"Filter holder by inequality.","schema":{"type":"string"}},{"name":"holder.like","in":"query","required":false,"description":"Case-insensitive contains filter for holder.","schema":{"type":"string"}},{"name":"asset_identifier","in":"query","required":false,"description":"Filter asset_identifier by equality.","schema":{"type":"string"}},{"name":"asset_identifier.neq","in":"query","required":false,"description":"Filter asset_identifier by inequality.","schema":{"type":"string"}},{"name":"asset_identifier.like","in":"query","required":false,"description":"Case-insensitive contains filter for asset_identifier.","schema":{"type":"string"}},{"name":"_id","in":"query","required":false,"description":"Filter _id by equality.","schema":{"type":"string"}},{"name":"_id.neq","in":"query","required":false,"description":"Filter _id by inequality.","schema":{"type":"string"}},{"name":"_id.gt","in":"query","required":false,"description":"Filter _id with gt.","schema":{"type":"string"}},{"name":"_id.gte","in":"query","required":false,"description":"Filter _id with gte.","schema":{"type":"string"}},{"name":"_id.lt","in":"query","required":false,"description":"Filter _id with lt.","schema":{"type":"string"}},{"name":"_id.lte","in":"query","required":false,"description":"Filter _id with lte.","schema":{"type":"string"}},{"name":"_block_height","in":"query","required":false,"description":"Filter _block_height by equality.","schema":{"type":"string"}},{"name":"_block_height.neq","in":"query","required":false,"description":"Filter _block_height by inequality.","schema":{"type":"string"}},{"name":"_block_height.gt","in":"query","required":false,"description":"Filter _block_height with gt.","schema":{"type":"string"}},{"name":"_block_height.gte","in":"query","required":false,"description":"Filter _block_height with gte.","schema":{"type":"string"}},{"name":"_block_height.lt","in":"query","required":false,"description":"Filter _block_height with lt.","schema":{"type":"string"}},{"name":"_block_height.lte","in":"query","required":false,"description":"Filter _block_height with lte.","schema":{"type":"string"}},{"name":"_tx_id","in":"query","required":false,"description":"Filter _tx_id by equality.","schema":{"type":"string"}},{"name":"_tx_id.neq","in":"query","required":false,"description":"Filter _tx_id by inequality.","schema":{"type":"string"}},{"name":"_tx_id.like","in":"query","required":false,"description":"Case-insensitive contains filter for _tx_id.","schema":{"type":"string"}},{"name":"_created_at","in":"query","required":false,"description":"Filter _created_at by equality.","schema":{"type":"string"}},{"name":"_created_at.neq","in":"query","required":false,"description":"Filter _created_at by inequality.","schema":{"type":"string"}},{"name":"_created_at.gt","in":"query","required":false,"description":"Filter _created_at with gt.","schema":{"type":"string"}},{"name":"_created_at.gte","in":"query","required":false,"description":"Filter _created_at with gte.","schema":{"type":"string"}},{"name":"_created_at.lt","in":"query","required":false,"description":"Filter _created_at with lt.","schema":{"type":"string"}},{"name":"_created_at.lte","in":"query","required":false,"description":"Filter _created_at with lte.","schema":{"type":"string"}},{"name":"_created_at.like","in":"query","required":false,"description":"Case-insensitive contains filter for _created_at.","schema":{"type":"string"}}],"responses":{"200":{"description":"Row count for the filtered table query.","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"}},"required":["count"],"example":{"count":28046}}}}}}}}},"components":{"schemas":{"holdingsRow":{"type":"object","properties":{"kind":{"type":"string"},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d+)?$"},"holder":{"type":"string"},"asset_identifier":{"type":"string"},"_id":{"type":"integer"},"_block_height":{"type":"string","pattern":"^-?\\d+(\\.\\d+)?$"},"_tx_id":{"type":"string"},"_created_at":{"type":"string","format":"date-time"}},"required":["kind","amount","holder","asset_identifier","_id","_block_height","_tx_id","_created_at"],"example":{"kind":"example","amount":"1000","holder":"SP000000000000000000002Q6VF78","asset_identifier":"example","_id":1,"_block_height":"1000","_tx_id":"example","_created_at":"2026-01-01T00:00:00.000Z"}}}},"x-secondlayer-subgraph":"asset-holdings","x-secondlayer-version":"1.0.0","x-secondlayer-schema-hash":"45f5c1a0927078bb54c25115d6cb0485bbf81133dc4e3157603a1cfff64a6b51","x-secondlayer-generated-at":"2026-08-03T12:52:37.152Z","x-secondlayer-sources":{"ftBurn":{"type":"ft_burn"},"ftMint":{"type":"ft_mint"},"ftXfer":{"type":"ft_transfer"},"stxBurn":{"type":"stx_burn"},"stxMint":{"type":"stx_mint"},"stxXfer":{"type":"stx_transfer"}},"x-secondlayer-tables":["holdings"]}