<!-- source: https://secondlayer.tools/docs/api-reference#subgraph-directory-object -->

## The Subgraph directory object

| Field | Type | Description |
| --- | --- | --- |
| `subgraphs` | array of SubgraphSummary | Every subgraph you can read. Not paginated. |
| `tip` | object | The chain tip this list was read against. |
| `envelope` | object | Fixed reminder of the row-read shape and cursor rules, for agents reading the directory cold. |

```json
{
  "subgraphs": [
    {
      "name": "sbtc-token",
      "description": null,
      "status": "active",
      "version": "1.0.0",
      "created_at": "2026-09-01T12:00:00.000Z",
      "total_rows": 48138,
      "sources": [
        "SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-token"
      ],
      "last_processed_block": 9048931,
      "blocks_behind": 0,
      "tables": [
        "transfers"
      ],
      "url": "/v1/subgraphs/sbtc-token"
    }
  ],
  "tip": {
    "block_height": 9048931
  },
  "envelope": {
    "rows": "GET /v1/subgraphs/:name/:table → { rows, next_cursor, tip }",
    "cursor": "_id keyset by default, or ?_sort=<column>&_order=asc|desc for a composite keyset; pass ?cursor=<next_cursor> to resume"
  }
}
```