> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockworksresearch.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Charts

> Retrieve a paginated list of available charts

## Overview

This endpoint returns a paginated list of charts available through the API. Use [Get Chart Data](/api-reference/charts/get-chart-data) to fetch the underlying chart data.

## Example Request

<CodeGroup>
  ```bash cURL theme={null}
  curl -H "x-api-key: YOUR_API_KEY" \
    "https://api.blockworks.com/v1/charts?limit=20"
  ```

  ```typescript TypeScript theme={null}
  const response = await fetch(
    'https://api.blockworks.com/v1/charts?limit=20',
    { headers: { 'x-api-key': 'YOUR_API_KEY' } }
  )
  const data = await response.json()
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.blockworks.com/v1/charts',
      headers={'x-api-key': 'YOUR_API_KEY'},
      params={'limit': 20}
  )
  data = response.json()
  ```
</CodeGroup>

### Example Response

```json theme={null}
{
  "data": [
    {
      "id": 3,
      "title": "Block Subsidy",
      "dashboards": []
    },
    {
      "id": 5,
      "title": "L1 Usage",
      "dashboards": []
    },
    {
      "id": 13,
      "title": "ETH Staking Yield (Weekly Basis Test Case)",
      "dashboards": [
        "Test Aaron"
      ]
    },
    {
      "id": 18,
      "title": "MEV Tips to Validators",
      "dashboards": []
    },
    {
      "id": 34,
      "title": "Arbitrum: Total Transaction Fees",
      "dashboards": []
    }
  ],
  "total": 3228,
  "page": 1
}
```

## Supported Options

| Name     | Type  | Details                                               |
| -------- | ----- | ----------------------------------------------------- |
| `limit`  | query | The number of charts to return (1-100, default: 100). |
| `page`   | query | The page number to return (default: 1).               |
| `search` | query | Search term to filter charts by title or description. |

## Notes

* Results are **paginated** — use `limit` and `page` query parameters to navigate.
* Chart identifiers returned here can be used to retrieve chart data via other endpoints.
* Use the `search` parameter to find specific charts by keywords.

## Related Endpoints

* [Get Chart Data](/api-reference/charts/get-data)
* [Get Chart Data with Slug](/api-reference/charts/get-data-with-slug)


## OpenAPI

````yaml GET /v1/charts
openapi: 3.0.0
info:
  title: Blockworks API
  description: ''
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.blockworks.com
security:
  - x-api-key: []
tags: []
paths:
  /v1/charts:
    get:
      tags:
        - Charts
      summary: List Charts
      description: Retrieve a paginated list of available charts.
      operationId: ChartsController_list
      parameters:
        - name: page
          required: false
          in: query
          schema:
            minimum: 1
            maximum: 2147483647
            default: 1
            type: integer
        - name: limit
          required: false
          in: query
          schema:
            minimum: 1
            maximum: 100
            default: 100
            type: integer
        - name: search
          required: false
          in: query
          schema:
            type: string
            maxLength: 255
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChartPageResponse'
        '400':
          description: Bad Request
      security:
        - x-api-key: []
components:
  schemas:
    ChartPageResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/ChartResponse'
        total:
          type: integer
        page:
          type: integer
      required:
        - data
        - total
        - page
    ChartResponse:
      type: object
      properties:
        id:
          type: integer
        title:
          type: string
        dashboards:
          type: array
          items:
            type: string
      required:
        - id
        - title
        - dashboards
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key

````