# bns-names Subgraph API
Version: 1.0.0
Schema hash: b9add291ef9275cbd8e89cfc2dc52cf1842eed0fc39d5a07239bbe24d2a5acb1
Server: https://api.secondlayer.tools
Visibility: public — anon reads, no API key. Responses use the `{ rows, next_cursor, tip }` envelope; paginate with `?cursor=<next_cursor>` and `_order=asc|desc` (`_offset`/`_sort` are rejected).
BNS-V2 name ownership and lifecycle

## names

GET https://api.secondlayer.tools/v1/subgraphs/bns-names/names
GET https://api.secondlayer.tools/v1/subgraphs/bns-names/names/count
GET https://api.secondlayer.tools/v1/subgraphs/bns-names/names/aggregate
GET https://api.secondlayer.tools/v1/subgraphs/bns-names/names/stream (SSE)

Rows: 0

### Columns

| Column | Type | Attributes |
| --- | --- | --- |
| `fqn` | `text` | indexed, searchable |
| `name` | `text` | indexed, searchable |
| `owner` | `principal` | nullable, indexed, searchable |
| `topic` | `text` | indexed |
| `namespace` | `text` | indexed, searchable |
| `_id` | `serial` | system |
| `_block_height` | `bigint` | system |
| `_tx_id` | `text` | system |
| `_created_at` | `timestamp` | system |

### Query

Parameters: `_limit`, `cursor`, `_order`, `_fields`, `_search`
Filters: `fqn`, `fqn.neq`, `fqn.like`, `name`, `name.neq`, `name.like`, `owner`, `owner.neq`, `owner.like`, `topic`, `topic.neq`, `topic.like`, `namespace`, `namespace.neq`, `namespace.like`, `_id`, `_id.neq`, `_id.gt`, `_id.gte`, `_id.lt`, `_id.lte`, `_block_height`, `_block_height.neq`, `_block_height.gt`, `_block_height.gte`, `_block_height.lt`, `_block_height.lte`, `_tx_id`, `_tx_id.neq`, `_tx_id.like`, `_created_at`, `_created_at.neq`, `_created_at.gt`, `_created_at.gte`, `_created_at.lt`, `_created_at.lte`, `_created_at.like`

### Example

```bash
curl 'https://api.secondlayer.tools/v1/subgraphs/bns-names/names?_limit=10&_order=desc'
```