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

# RWA List with Market Data

> Returns a paginated list of tokenized real-world assets with real-world and tokenized market data side by side.<br/><br/>Available from&#58; <Badge color="blue">Basic</Badge><br/>Cost&#58; <Badge color="surface">1 credit per request</Badge>

> [!NOTE]
>
> price, marketCap and volume24h describe the real-world asset on its home market; tokenized\* fields aggregate all tokens tracking it. All monetary values are in USD.

> [!NOTE]
>
> Commodities have no volume24h; it is returned as null. Pre-ipo assets have null symbol, price and marketCap; tokenizedPrice is the main token price; rank is by tokenizedMarketCap when the main token has a price, otherwise by latest funding valuation then name (separate from the real-world marketCap rank of other types). Pre-ipo without linked tokens are omitted.

> [!TIP]
>
> Get every token behind an asset with /rwa/{id}/tokens.


## OpenAPI

````yaml /openapi.json get /v3/rwa/list
openapi: 3.0.0
info:
  contact:
    email: info@cryptorank.io
    name: Cryptorank Team
    url: https://cryptorank.io
  description: >
    # Overview


    Cryptorank Public API v3 — comprehensive cryptocurrency data for B2B clients
    and partners.


    Useful Links:

    - [API Plans](https://cryptorank.io/public-api)

    - [Dashboard](https://cryptorank.io/public-api/dashboard)


    # Getting Started


    Primary Server URL:
    [https://api.cryptorank.io/v3/](https://api.cryptorank.io/v3/)


    **Authentication**


    Generate an API key in the
    [dashboard](https://cryptorank.io/public-api/dashboard) and pass it in the
    `X-Api-Key` header.


    Keep your keys secret — never commit them to public repositories or expose
    them in client-side code.
  title: Cryptorank API V3
  version: 3.0.0
servers:
  - url: https://api.cryptorank.io
security: []
tags: []
paths:
  /v3/rwa/list:
    get:
      tags:
        - Real World Assets
      summary: RWA List with Market Data
      description: >-
        **Description**


        Returns a paginated list of tokenized real-world assets with real-world
        and tokenized market data side by side.


        > **Note:** price, marketCap and volume24h describe the real-world asset
        on its home market; tokenized* fields aggregate all tokens tracking it.
        All monetary values are in USD.


        > **Note:** Commodities have no volume24h; it is returned as null.
        Pre-ipo assets have null symbol, price and marketCap; tokenizedPrice is
        the main token price; rank is by tokenizedMarketCap when the main token
        has a price, otherwise by latest funding valuation then name (separate
        from the real-world marketCap rank of other types). Pre-ipo without
        linked tokens are omitted.


        > **Tip:** Get every token behind an asset with /rwa/{id}/tokens.


        **Access**

        - Available from: **Basic**

        - Cost: 1 credit per request
      operationId: RwaController_getList
      parameters:
        - description: Page number (1-based). Returns up to 100 items per page.
          in: query
          name: page
          required: false
          schema:
            default: 1
            maximum: 1000
            minimum: 1
            type: number
        - description: 'Filter by asset type: stock | etf | bond | commodity | pre-ipo.'
          in: query
          name: type
          required: false
          schema:
            enum:
              - stock
              - etf
              - bond
              - commodity
              - pre-ipo
            type: string
        - description: >-
            Comma-separated RWA IDs, up to 100. Unknown IDs are skipped. See:
            GET /v3/rwa/map.
          in: query
          name: rwaIds
          required: false
          schema:
            example: 1,12,34
            type: string
        - description: Sort field.
          in: query
          name: sortBy
          required: false
          schema:
            default: rank
            enum:
              - rank
              - marketCap
              - tokenizedMarketCap
              - tokenizedVolume24h
              - priceChangePercent24h
            type: string
        - description: Sort direction. For `rank`, `asc` puts top-1 first.
          in: query
          name: sortOrder
          required: false
          schema:
            default: asc
            enum:
              - asc
              - desc
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  data:
                    items:
                      $ref: '#/components/schemas/RwaListItemDto'
                    type: array
                  meta:
                    $ref: '#/components/schemas/ListMetaDto'
                  status:
                    $ref: '#/components/schemas/ResponseStatusDto'
                required:
                  - data
                  - meta
                  - status
                type: object
          description: ''
        '400':
          content:
            application/json:
              schema:
                properties:
                  error:
                    properties:
                      code:
                        enum:
                          - VALIDATION_ERROR
                        example: VALIDATION_ERROR
                        type: string
                      message:
                        example: Validation failed
                        type: string
                      status:
                        example: 400
                        type: number
                    required:
                      - code
                      - message
                      - status
                    type: object
                required:
                  - error
                type: object
          description: Request validation failed
        '401':
          content:
            application/json:
              schema:
                properties:
                  error:
                    properties:
                      code:
                        enum:
                          - API_KEY_MISSING
                          - API_KEY_INVALID
                        example: API_KEY_MISSING
                        type: string
                      message:
                        example: API key is missing
                        type: string
                      status:
                        example: 401
                        type: number
                    required:
                      - code
                      - message
                      - status
                    type: object
                required:
                  - error
                type: object
          description: API key is missing or invalid
        '403':
          content:
            application/json:
              schema:
                properties:
                  error:
                    properties:
                      code:
                        enum:
                          - NO_ACTIVE_SUBSCRIPTION
                          - ENDPOINT_NOT_AVAILABLE
                          - PLAN_LIMIT_EXCEEDED
                        example: NO_ACTIVE_SUBSCRIPTION
                        type: string
                      message:
                        example: No active subscription found
                        type: string
                      status:
                        example: 403
                        type: number
                    required:
                      - code
                      - message
                      - status
                    type: object
                required:
                  - error
                type: object
          description: >-
            No active subscription, the endpoint is not available in your plan,
            or the request goes beyond what your plan allows
        '429':
          content:
            application/json:
              schema:
                properties:
                  error:
                    properties:
                      code:
                        enum:
                          - RATE_LIMIT_EXCEEDED
                          - DAILY_CREDITS_EXCEEDED
                          - MONTHLY_CREDITS_EXCEEDED
                        example: RATE_LIMIT_EXCEEDED
                        type: string
                      message:
                        example: Rate limit exceeded
                        type: string
                      status:
                        example: 429
                        type: number
                    required:
                      - code
                      - message
                      - status
                    type: object
                required:
                  - error
                type: object
          description: Rate limit or credit limit exceeded
        '500':
          content:
            application/json:
              schema:
                properties:
                  error:
                    properties:
                      code:
                        enum:
                          - INTERNAL_ERROR
                        example: INTERNAL_ERROR
                        type: string
                      message:
                        example: Internal server error
                        type: string
                      status:
                        example: 500
                        type: number
                    required:
                      - code
                      - message
                      - status
                    type: object
                required:
                  - error
                type: object
          description: Internal server error
      security:
        - X-Api-Key: []
components:
  schemas:
    RwaListItemDto:
      properties:
        id:
          description: Unique numeric identifier.
          example: 1
          type: number
        imageUrl:
          description: Logo image URL, 150×150. Null when no image is available.
          example: https://images.cryptorank.io/coins/150x150.apple.png
          nullable: true
          type: string
        isLeveraged:
          description: Whether the asset is a leveraged or inverse product.
          example: false
          type: boolean
        marketCap:
          description: >-
            Real-world market cap, USD. For commodities — estimated world supply
            × price. Null when unavailable (including pre-ipo assets).
          example: '2900000000000'
          nullable: true
          type: string
        name:
          description: Display name.
          example: Apple Inc.
          type: string
        price:
          description: >-
            Real-world price, USD. Null when unavailable (including pre-ipo
            assets).
          example: '189.84'
          nullable: true
          type: string
        priceChangePercent24h:
          description: Real-world price change over 24h, %. Null when unavailable.
          example: 1.23
          nullable: true
          type: number
        priceChangePercent7d:
          description: Real-world price change over 7d, %. Null when unavailable.
          example: -2.45
          nullable: true
          type: number
        rank:
          description: >-
            Position in the section. Listed assets — by real-world market cap;
            pre-ipo — by tokenized market cap when the main token has a price,
            otherwise by latest funding valuation then name.
          example: 1
          type: number
        slug:
          description: URL-friendly asset slug.
          example: apple
          type: string
        symbol:
          description: Ticker of the real-world asset. Null for pre-ipo assets.
          example: AAPL
          nullable: true
          type: string
        tokenizedMarketCap:
          description: >-
            Combined market cap of all tokens tracking the asset, USD. Null when
            unavailable.
          example: '125000000'
          nullable: true
          type: string
        tokenizedPremiumPercent:
          description: >-
            Tokenized price vs real-world price, %. Negative means a discount.
            Null when tokenizedPrice is null.
          example: 0.15
          nullable: true
          type: number
        tokenizedPrice:
          description: >-
            Tokenized price, USD. For stock/etf/bond/commodity — volume-weighted
            average across tokens; for pre-ipo — price of the main token. Null
            when no token has a price.
          example: '190.12'
          nullable: true
          type: string
        tokenizedVolume24h:
          description: >-
            Combined 24h trading volume of all tokens tracking the asset, USD.
            Null when unavailable.
          example: '8400000'
          nullable: true
          type: string
        tokensCount:
          description: Number of tokens tracking the asset.
          example: 3
          type: number
        type:
          description: 'Asset type: stock | etf | bond | commodity | pre-ipo.'
          enum:
            - stock
            - etf
            - bond
            - commodity
            - pre-ipo
          example: stock
          type: string
        volume24h:
          description: >-
            Real-world 24h trading volume, USD. Null for commodities and pre-ipo
            assets.
          example: '5200000000'
          nullable: true
          type: string
      required:
        - id
        - rank
        - slug
        - symbol
        - name
        - type
        - imageUrl
        - isLeveraged
        - price
        - tokenizedPrice
        - tokenizedPremiumPercent
        - priceChangePercent24h
        - priceChangePercent7d
        - marketCap
        - volume24h
        - tokenizedMarketCap
        - tokenizedVolume24h
        - tokensCount
      type: object
    ListMetaDto:
      properties:
        hasNextPage:
          description: Whether a further page of results exists
          example: true
          type: boolean
        page:
          description: Current page number (1-based)
          example: 1
          type: number
        pageSize:
          description: >-
            Fixed number of items per page for this endpoint (varies per
            endpoint)
          example: 25
          type: number
      required:
        - page
        - pageSize
        - hasNextPage
      type: object
    ResponseStatusDto:
      properties:
        timestamp:
          description: Server time of the response. Unix timestamp in milliseconds
          example: 1780000000000
          type: number
        usedCredits:
          description: Credits charged for this request
          example: 1
          type: number
      required:
        - usedCredits
        - timestamp
      type: object
  securitySchemes:
    X-Api-Key:
      in: header
      name: X-Api-Key
      type: apiKey

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.