> ## 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.

# Get Single Asset Supply

> Retrieve supply data for a specific asset

## Overview

Get the supply information for a specific asset. This endpoint returns just the supply data block with `asset_code` and `asset_slug` included.

## Example Request

<CodeGroup>
  ```bash cURL theme={null}
  curl -H "x-api-key: YOUR_API_KEY" \
    "https://api.blockworks.com/v1/assets/ethereum/supply"
  ```

  ```typescript TypeScript theme={null}
  const res = await fetch(
    'https://api.blockworks.com/v1/assets/ethereum/supply',
    { headers: { 'x-api-key': 'YOUR_API_KEY' } }
  )
  const data = await res.json()
  ```

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

  r = requests.get(
    'https://api.blockworks.com/v1/assets/ethereum/supply',
    headers={'x-api-key': 'YOUR_API_KEY'}
  )
  data = r.json()
  ```
</CodeGroup>

## Example Response

```json theme={null}
{
  "circulating": 120702472.20949,
  "liquid": 0,
  "total": 120702572.39159,
  "asset_code": "ETH",
  "asset_slug": "ethereum"
}
```

### Response Fields

| Field         | Type   | Description                                |
| ------------- | ------ | ------------------------------------------ |
| `circulating` | number | Number of tokens currently in circulation  |
| `liquid`      | number | Liquid supply amount                       |
| `total`       | number | Total token supply including locked tokens |
| `asset_code`  | string | Asset code (e.g., "ETH")                   |
| `asset_slug`  | string | Asset slug (e.g., "ethereum")              |

## Notes

* This endpoint is equivalent to using `?expand=supply` on the `/v1/assets/{idOrSlug}` endpoint, but returns only the supply data.
* The response includes `asset_code` and `asset_slug` for easy identification.

## See also

* [Get Single Asset](/api-reference/assets/get-single)
* [Supply (Expand Parameter)](/api-reference/assets/expand/supply)
* [All Assets](/api-reference/assets/list)


## OpenAPI

````yaml GET /v1/assets/{idOrSlug}/supply
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/assets/{idOrSlug}/supply:
    get:
      tags:
        - assets
      summary: Get Asset Supply
      description: >-
        Get supply data for a single asset. Returns only the supply data with
        asset identifiers.
      operationId: AssetController_getSupply_v1
      parameters:
        - name: idOrSlug
          required: true
          in: path
          schema:
            type: string
      responses:
        '200':
          description: Supply data for the specified asset
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssetSupplyWithIdentifiers'
              example:
                circulating: 120702472.20949
                liquid: 0
                total: 120702572.39159
                asset_code: ETH
                asset_slug: ethereum
        '400':
          description: Bad Request
        '404':
          description: Not Found
components:
  schemas:
    AssetSupplyWithIdentifiers:
      type: object
      properties:
        circulating:
          type: number
          nullable: true
          format: double
        liquid:
          type: number
          nullable: true
          format: double
        total:
          type: number
          nullable: true
          format: double
        asset_code:
          type: string
          maxLength: 20
        asset_slug:
          type: string
          maxLength: 100
      required:
        - circulating
        - liquid
        - total
        - asset_code
        - asset_slug
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key

````