{"openapi":"3.1.0","info":{"title":"bns-names Subgraph API","version":"1.0.0","description":"BNS-V2 name ownership and lifecycle"},"servers":[{"url":"https://api.secondlayer.tools"}],"paths":{"/v1/subgraphs/bns-names/names":{"get":{"summary":"Query bns-names.names","operationId":"query_bns_names_names","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":"fqn","in":"query","required":false,"description":"Filter fqn by equality.","schema":{"type":"string"}},{"name":"fqn.neq","in":"query","required":false,"description":"Filter fqn by inequality.","schema":{"type":"string"}},{"name":"fqn.like","in":"query","required":false,"description":"Case-insensitive contains filter for fqn.","schema":{"type":"string"}},{"name":"name","in":"query","required":false,"description":"Filter name by equality.","schema":{"type":"string"}},{"name":"name.neq","in":"query","required":false,"description":"Filter name by inequality.","schema":{"type":"string"}},{"name":"name.like","in":"query","required":false,"description":"Case-insensitive contains filter for name.","schema":{"type":"string"}},{"name":"owner","in":"query","required":false,"description":"Filter owner by equality.","schema":{"type":"string"}},{"name":"owner.neq","in":"query","required":false,"description":"Filter owner by inequality.","schema":{"type":"string"}},{"name":"owner.like","in":"query","required":false,"description":"Case-insensitive contains filter for owner.","schema":{"type":"string"}},{"name":"topic","in":"query","required":false,"description":"Filter topic by equality.","schema":{"type":"string"}},{"name":"topic.neq","in":"query","required":false,"description":"Filter topic by inequality.","schema":{"type":"string"}},{"name":"topic.like","in":"query","required":false,"description":"Case-insensitive contains filter for topic.","schema":{"type":"string"}},{"name":"namespace","in":"query","required":false,"description":"Filter namespace by equality.","schema":{"type":"string"}},{"name":"namespace.neq","in":"query","required":false,"description":"Filter namespace by inequality.","schema":{"type":"string"}},{"name":"namespace.like","in":"query","required":false,"description":"Case-insensitive contains filter for namespace.","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/namesRow"}},"next_cursor":{"type":["string","null"]},"tip":{"type":"object","properties":{"block_height":{"type":"integer"},"subgraph_height":{"type":"integer"},"blocks_behind":{"type":"integer"}}}}}}}}}}},"/v1/subgraphs/bns-names/names/count":{"get":{"summary":"Count bns-names.names","operationId":"count_bns_names_names","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":"fqn","in":"query","required":false,"description":"Filter fqn by equality.","schema":{"type":"string"}},{"name":"fqn.neq","in":"query","required":false,"description":"Filter fqn by inequality.","schema":{"type":"string"}},{"name":"fqn.like","in":"query","required":false,"description":"Case-insensitive contains filter for fqn.","schema":{"type":"string"}},{"name":"name","in":"query","required":false,"description":"Filter name by equality.","schema":{"type":"string"}},{"name":"name.neq","in":"query","required":false,"description":"Filter name by inequality.","schema":{"type":"string"}},{"name":"name.like","in":"query","required":false,"description":"Case-insensitive contains filter for name.","schema":{"type":"string"}},{"name":"owner","in":"query","required":false,"description":"Filter owner by equality.","schema":{"type":"string"}},{"name":"owner.neq","in":"query","required":false,"description":"Filter owner by inequality.","schema":{"type":"string"}},{"name":"owner.like","in":"query","required":false,"description":"Case-insensitive contains filter for owner.","schema":{"type":"string"}},{"name":"topic","in":"query","required":false,"description":"Filter topic by equality.","schema":{"type":"string"}},{"name":"topic.neq","in":"query","required":false,"description":"Filter topic by inequality.","schema":{"type":"string"}},{"name":"topic.like","in":"query","required":false,"description":"Case-insensitive contains filter for topic.","schema":{"type":"string"}},{"name":"namespace","in":"query","required":false,"description":"Filter namespace by equality.","schema":{"type":"string"}},{"name":"namespace.neq","in":"query","required":false,"description":"Filter namespace by inequality.","schema":{"type":"string"}},{"name":"namespace.like","in":"query","required":false,"description":"Case-insensitive contains filter for namespace.","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":0}}}}}}}}},"components":{"schemas":{"namesRow":{"type":"object","properties":{"fqn":{"type":"string"},"name":{"type":"string"},"owner":{"type":["string","null"]},"topic":{"type":"string"},"namespace":{"type":"string"},"_id":{"type":"integer"},"_block_height":{"type":"string","pattern":"^-?\\d+(\\.\\d+)?$"},"_tx_id":{"type":"string"},"_created_at":{"type":"string","format":"date-time"}},"required":["fqn","name","topic","namespace","_id","_block_height","_tx_id","_created_at"],"example":{"fqn":"example","name":"example","owner":"SP000000000000000000002Q6VF78","topic":"example","namespace":"example","_id":1,"_block_height":"1000","_tx_id":"example","_created_at":"2026-01-01T00:00:00.000Z"}}}},"x-secondlayer-subgraph":"bns-names","x-secondlayer-version":"1.0.0","x-secondlayer-schema-hash":"b9add291ef9275cbd8e89cfc2dc52cf1842eed0fc39d5a07239bbe24d2a5acb1","x-secondlayer-generated-at":"2026-06-18T03:53:03.577Z","x-secondlayer-sources":{"bns":{"type":"print_event","contractId":"SP2QEZ06AGJ3RKJPBV14SY1V5BBFNAW33D96YPGZF.BNS-V2"}},"x-secondlayer-tables":["names"]}