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

> Retrieve a list of all available crypto assets with their key metadata

## Overview

This endpoint returns a **paginated list of crypto assets** supported by the API.
Each asset includes its identifier, symbol, slug, description, and other metadata used across API endpoints.
Use this endpoint to **discover assets** before querying metrics, prices, or other detailed data.

## Example Request

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

  ```typescript TypeScript theme={null}
  const response = await fetch(
    'https://api.blockworks.com/v1/assets?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/assets',
      headers={'x-api-key': 'YOUR_API_KEY'},
      params={'limit': 20}
  )
  data = response.json()
  ```
</CodeGroup>

### Example Response

A successful response returns a paginated list of assets.

```json theme={null}
{
  "data": [
    {
      "id": 1,
      "code": "NEAR",
      "title": "NEAR Protocol",
      "slug": "near-protocol",
      "tag_line": "A scalable, developer-friendly blockchain",
      "description": "NEAR is a decentralized development platform that uses a Proof-of-Stake (PoS) consensus mechanism and will eventually feature a sharded architecture to scale transaction throughput. Its block generation scheme is called Doomslug and its proposed sharding design is dubbed Nightshade. These technologies will work together to scale the network and minimize congestion. NEAR has also been designed to be developer and user-friendly as it features a few key innovations to accelerate the application development and user-onboarding processes. The NEAR blockchain was created and developed by the NEAR Foundation. Its mainnet went live in April 2020, and network validators voted to unlock token transfers in October 2020. NEAR's bridge to Ethereum (called the Rainbow Bridge) launched in March 2021.",
      "image_url": "https://coin-images.coingecko.com/coins/images/10365/large/near.jpg?1696510367",
      "category": "Infrastructure",
      "updated_at": 1761160398,
      "type": "Infrastructure",
      "sector": "L1"
    },
    ... // more assets
  ],
  "total": 133030,
  "page": 1
}
```

## Supported Options

| Name     | Type  | Details                                                        |
| -------- | ----- | -------------------------------------------------------------- |
| `expand` | query | The fields to expand. See **Expand Options** for more details. |
| `limit`  | query | The number of assets to return.                                |
| `page`   | query | The page number to return.                                     |

## Response Fields

| Field         | Type   | Description                                 |
| ------------- | ------ | ------------------------------------------- |
| `category`    | string | Asset category (e.g., Infrastructure, DeFi) |
| `code`        | string | Asset ticker symbol (e.g., BTC, ETH)        |
| `description` | string | Detailed asset description                  |
| `id`          | number | Unique asset identifier                     |
| `image_url`   | string | URL to asset logo/image                     |
| `sector`      | string | Sector of the asset                         |
| `slug`        | string | URL-friendly identifier                     |
| `tag_line`    | string | Short description or tagline                |
| `title`       | string | Full asset name                             |
| `type`        | string | Asset type classification                   |
| `updated_at`  | number | Unix timestamp of last update               |

## Notes

* Results are **paginated** — use `limit` and `page` query parameters to navigate.
* Asset identifiers returned here can be used as `project` or `asset` parameters in other API endpoints.

## Related Endpoints

* [Get Single Asset](/api-reference/assets/get-single)


## OpenAPI

````yaml GET /v1/assets
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:
    get:
      tags:
        - assets
      summary: List Assets
      description: >-
        List assets with pagination and optional filters (`code`, `slug`,
        `category`, etc.). Use `expand` to include related fields (e.g.,
        `price`, `markets`, `supply`).
      operationId: AssetController_list_v1
      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: 1000
            default: 100
            type: integer
        - name: code
          required: false
          in: query
          schema:
            type: string
            nullable: true
            maxLength: 20
        - name: slug
          required: false
          in: query
          schema:
            type: string
            nullable: true
            maxLength: 100
        - name: category
          required: false
          in: query
          schema:
            maxLength: 255
            type: array
            items:
              type: string
        - name: ids_or_codes
          required: false
          in: query
          schema:
            maxLength: 255
            type: array
            items:
              type: string
        - name: favorites
          required: false
          in: query
          schema:
            type: boolean
        - name: expand
          required: false
          in: query
          schema:
            type: array
            items:
              type: string
              enum:
                - addresses
                - chains
                - addresses.chain
                - markets
                - market_cap
                - ohlcv_last_24_h
                - price
                - reference
                - sector
                - supply
        - name: query
          required: false
          in: query
          schema:
            maxLength: 65535
            format: json
            type: string
        - name: order_by
          required: false
          in: query
          schema:
            enum:
              - code
              - slug
              - market_cap.rank
              - market_cap.percent_change_usd_1_h
              - market_cap.percent_change_usd_24_h
              - market_cap.usd
              - markets.volume_24_h
              - price.usd
              - sector.title
              - supply.total
            type: string
        - name: order_dir
          required: false
          in: query
          schema:
            default: asc
            enum:
              - asc
              - desc
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssetPageResponse'
        '400':
          description: Bad Request
components:
  schemas:
    AssetPageResponse:
      type: object
      properties:
        page:
          type: integer
          minimum: 1
          maximum: 2147483647
        total:
          type: integer
          minimum: 1
          maximum: 100
        data:
          type: array
          items:
            $ref: '#/components/schemas/AssetResponseBase'
      required:
        - page
        - total
        - data
    AssetResponseBase:
      type: object
      properties:
        id:
          type: integer
          minimum: 0
          maximum: 4294967295
        code:
          type: string
          nullable: true
          maxLength: 20
        title:
          type: string
          nullable: true
          maxLength: 100
        slug:
          type: string
          nullable: true
          maxLength: 100
        tag_line:
          type: string
          nullable: true
          maxLength: 255
        description:
          type: string
          nullable: true
          maxLength: 65535
        image_url:
          type: string
          nullable: true
          maxLength: 255
        sector:
          type: string
          nullable: true
          maxLength: 50
        category:
          type: string
          nullable: true
          maxLength: 25
        updated_at:
          type: number
          nullable: true
          description: Unix timestamp
        type:
          type: string
          nullable: true
          enum:
            - Infrastructure
            - Application
        market_cap:
          description: Expandable relationship
          allOf:
            - $ref: '#/components/schemas/MarketCap'
        price:
          description: Expandable relationship
          allOf:
            - $ref: '#/components/schemas/Price'
      required:
        - id
        - code
        - title
        - slug
        - tag_line
        - description
        - image_url
        - sector
        - category
        - updated_at
        - type
    MarketCap:
      type: object
      properties:
        asset_id:
          type: integer
          minimum: 0
          maximum: 4294967295
        rank:
          type: integer
          nullable: true
          minimum: 0
          maximum: 4294967295
        usd:
          type: number
          nullable: true
          format: double
          minimum: 2.2250738585072014e-308
          maximum: 1.7976931348623157e+308
        dominance:
          type: number
          nullable: true
          format: float
          minimum: 1.17549435e-38
          maximum: 3.402823e+38
        percent_change_btc_1_h:
          type: number
          nullable: true
          format: float
          minimum: 1.17549435e-38
          maximum: 3.402823e+38
        percent_change_btc_24_h:
          type: number
          nullable: true
          format: float
          minimum: 1.17549435e-38
          maximum: 3.402823e+38
        percent_change_usd_1_h:
          type: number
          nullable: true
          format: float
          minimum: 1.17549435e-38
          maximum: 3.402823e+38
        percent_change_usd_24_h:
          type: number
          nullable: true
          format: float
          minimum: 1.17549435e-38
          maximum: 3.402823e+38
        percent_change_eth_1_h:
          type: number
          nullable: true
          format: float
          minimum: 1.17549435e-38
          maximum: 3.402823e+38
        percent_change_eth_24_h:
          type: number
          nullable: true
          format: float
          minimum: 1.17549435e-38
          maximum: 3.402823e+38
        updated_at:
          type: number
          nullable: true
          description: Unix timestamp
      required:
        - asset_id
        - rank
        - usd
        - dominance
        - percent_change_btc_1_h
        - percent_change_btc_24_h
        - percent_change_usd_1_h
        - percent_change_usd_24_h
        - percent_change_eth_1_h
        - percent_change_eth_24_h
        - updated_at
    Price:
      type: object
      properties:
        asset_id:
          type: integer
          minimum: 0
          maximum: 4294967295
        usd:
          type: number
          nullable: true
          format: double
          minimum: 2.2250738585072014e-308
          maximum: 1.7976931348623157e+308
        btc:
          type: number
          nullable: true
          format: double
          minimum: 2.2250738585072014e-308
          maximum: 1.7976931348623157e+308
        eth:
          type: number
          nullable: true
          format: double
          minimum: 2.2250738585072014e-308
          maximum: 1.7976931348623157e+308
        sparkline_7d:
          type: string
          nullable: true
          maxLength: 65535
        updated_at:
          type: number
          nullable: true
          description: Unix timestamp
      required:
        - asset_id
        - usd
        - btc
        - eth
        - sparkline_7d
        - updated_at
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key

````