<!-- source: https://secondlayer.tools/docs/api-reference#list-runes -->

## Rune catalog

`GET /v1/index/runes`

Every etched rune, with the identity bundle (id, name, spaced_name, symbol, divisibility) every Runes response carries plus its computed supply, mint/burn counters and mint terms. `search` prefix-matches the name (spacers and case ignored); `sort` is etch order (`number`, default) or busiest-first (`mints`).

### Filters

| Name | Type | Description |
| --- | --- | --- |
| `search` | string | Name prefix, spacers and case ignored (e.g. `dog` matches `DOG•GO•TO•THE•MOON`). |
| `sort` | enum | `number` (etch order, oldest first — default) or `mints` (busiest first). Values: `number`, `mints`. |

### Range and paging

| Name | Type | Description |
| --- | --- | --- |
| `cursor` | string | Opaque token from a previous page's `next_cursor`. Resumes after it — pass back unchanged. |
| `limit` | integer · 1 to 1000 | Page size; capped at 1000. |

### Returns

A cursor envelope; `runes` holds `RuneEntry` objects.

### Responses

- `200` Cursor-paginated envelope
- `400` A parameter, filter, cursor or body field was refused; `code` says which
- `401` This bind requires the instance token, and it was missing or wrong
- `429` Rate limited; retry after `Retry-After` seconds

### Example

```bash
curl https://api.secondlayer.tools/v1/index/runes \
  -H "Authorization: Bearer $SECONDLAYER_API_KEY"
```

```json
{
  "runes": [
    {
      "id": "840000:3",
      "number": "3",
      "name": "DOGGOTOTHEMOON",
      "spaced_name": "DOG•GO•TO•THE•MOON",
      "symbol": "🐕",
      "divisibility": 5,
      "premine": "10000000000000000",
      "supply": "10000000000000000",
      "burned": "2440680717188",
      "mints": "0",
      "turbo": false,
      "etching_txid": "e79134080a83fe3e0e06ed6990c5a9b63b362313341745707a2bff7d788a1375",
      "etched_height": 840000,
      "etched_tx_index": 3,
      "terms": null
    }
  ],
  "tip": {
    "block_height": 968925,
    "finalized_height": 968919,
    "lag_seconds": 210
  },
  "reorgs": [
    {
      "id": "7",
      "detected_at": "2026-08-11T04:22:10.000Z",
      "fork_point_height": 851203,
      "old_hash": "0000000000000000000123abc1230000000000000000000000000000000000",
      "new_hash": "0000000000000000000456def4560000000000000000000000000000000000",
      "orphaned_from": 851203,
      "orphaned_to": 851204,
      "new_tip_height": 851205
    }
  ]
}
```