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

# Get Rwa Tokens

> List tokens representing a real-world asset

<Note>**2** credits per request</Note><hr />

<Accordion title="Required">
  * rwaId: Asset ID from /rwa/assets.
</Accordion>

<Accordion title="You will get">
  * Token issuers, contracts and networks, CoinStats coin mappings, prices, and available filter options.
</Accordion>

<Accordion title="Optional">
  * issuer, network, search, sortBy, sortDirection, page, limit, currency.
</Accordion>

<Info>Use IDs returned in filters. Coin links and market data require a unique current mapping; unavailable values remain null. Defaults: volume desc, page 1, limit 100 (maximum 100).</Info>


## OpenAPI

````yaml /api-reference/openapi.json get /v1/rwa/assets/{rwaId}/tokens
openapi: 3.0.0
info:
  title: CoinStats Public API
  description: >-
    CoinStats Public API — programmatic access to market data, news, NFTs,
    wallets, exchange connections, and user portfolios. Authenticate every
    request with the `X-API-KEY` header (or an OAuth Bearer token in the
    `Authorization` header). Generate keys at https://openapi.coinstats.app.
  version: '1.0'
  contact: {}
servers:
  - url: https://api.coinstats.app
security: []
tags:
  - name: CoinStats
    description: ''
  - name: Market Data
    description: >-
      The Market Data section of the API provides endpoints to access a wide
      range of market-related information, including cryptocurrency coins,
      ticker data, and fiat currency rates. This category offers comprehensive
      data to help users monitor and analyze the cryptocurrency market, track
      prices, and gain insights into market trends
  - name: RWA
    description: >-
      Tokenized real-world assets: overview, stocks, commodities, ETFs, tokens,
      trading markets, and aggregate or per-asset history.
  - name: News
    description: >-
      The News section of the API allows you to access news articles and updates
      related to cryptocurrencies and the blockchain industry. It provides
      valuable information from various sources to keep you informed about the
      latest developments
  - name: NFTs
    description: >-
      The NFT section of the API provides endpoints to interact with
      Non-Fungible Tokens (NFTs), which are unique digital assets stored on a
      blockchain. These endpoints allow you to retrieve information about NFTs,
      including collections, assets, trending NFTs, and specific assets
      associated with wallet addresses.
  - name: Wallet Data
    description: >-
      The Wallet section of the API provides a comprehensive set of endpoints to
      manage and interact with wallets. It enables users to retrieve wallet
      balances, monitor syncing status, fetch transaction data, and synchronize
      wallet information with the blockchain. By integrating these endpoints
      into your application, you can offer robust wallet functionality to your
      users.
  - name: Exchange Connection
    description: >-
      The Exchange Connection section of the API provides a comprehensive set of
      endpoints to manage and interact with exchanges. It enables users to
      retrieve exchange balances, monitor syncing status, fetch transaction
      data. By integrating these endpoints into your application, you can offer
      robust exchange portfolio tracking functionality to your users.
  - name: User Portfolio
    description: >-
      The Portfolio section of the API provides a comprehensive set of endpoints
      to manage and interact with Share Portfolios. It enables users to retrieve
      current Portfolio Coins and Transactions.
  - name: Usage
    description: The Usage section provides account-level API usage data.
  - name: Status
    description: The Status section provides API availability checks.
  - name: Prediction · Markets
    description: >-
      Polymarket markets: list/trend/detail, live CLOB prices and order book,
      OHLC candles, and price history. Prices are probabilities in 0..1, money
      is USD, dates are ISO 8601.
  - name: Prediction · Events
    description: >-
      Polymarket events — groups of related markets (e.g. one market per
      candidate). List, trend, and fetch an event with its child markets.
  - name: Prediction · Traders
    description: >-
      Trader leaderboard plus deep per-trader analytics: profile, open
      positions, trade history, daily PnL, category stats, aggregate trade
      stats, and composite score.
  - name: Prediction · Analytics
    description: >-
      Platform-wide analytics: overview stats, smart-money and whale traders,
      trending-by-smart-money markets, and composite market signals.
  - name: Prediction · Search
    description: Full-text search across Polymarket events, markets, and traders.
paths:
  /v1/rwa/assets/{rwaId}/tokens:
    get:
      tags:
        - RWA
      summary: List tokens representing a real-world asset
      operationId: get-rwa-tokens
      parameters:
        - name: rwaId
          required: true
          in: path
          description: >-
            RWA asset ID returned by /rwa/assets. This is separate from a
            cryptocurrency coinId.
          schema:
            type: string
            example: gold
        - name: currency
          required: false
          in: query
          description: >-
            Uppercase currency code from /currencies. Monetary values use this
            currency; percentages and quantities are unchanged.
          schema:
            default: USD
            type: string
        - name: page
          required: false
          in: query
          description: Page number. The page offset must also be a safe integer.
          schema:
            minimum: 1
            maximum: 9007199254740991
            default: 1
            type: number
        - name: limit
          required: false
          in: query
          schema:
            minimum: 1
            maximum: 100
            default: 100
            type: number
        - name: search
          required: false
          in: query
          description: Literal, case-insensitive substring search.
          schema:
            maxLength: 100
            type: string
        - name: sortDirection
          required: false
          in: query
          description: Null values sort last in either direction.
          schema:
            default: desc
            type: string
            enum:
              - asc
              - desc
        - name: issuer
          required: false
          in: query
          description: Issuer ID returned in filters.issuers.
          schema:
            maxLength: 300
            type: string
        - name: network
          required: false
          in: query
          description: Platform ID returned in filters.networks.
          schema:
            maxLength: 300
            example: ethereum
            type: string
        - name: sortBy
          required: false
          in: query
          schema:
            default: volume
            type: string
            enum:
              - name
              - price
              - marketCap
              - volume
              - change24h
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RwaTokensResponseDto'
        '400':
          description: Bad Request
          content:
            application/json:
              example:
                statusCode: 400
                message: Bad Request
                requestId: 11111111-2222-3333-4444-555555555555
                path: <requested-endpoint>
        '401':
          description: Unauthorized
          content:
            application/json:
              example:
                statusCode: 401
                message: Unauthorized
                requestId: 11111111-2222-3333-4444-555555555555
                path: <requested-endpoint>
        '403':
          description: Forbidden
          content:
            application/json:
              example:
                statusCode: 403
                message: Forbidden
                requestId: 11111111-2222-3333-4444-555555555555
                path: <requested-endpoint>
        '404':
          description: Not Found
          content:
            application/json:
              example:
                statusCode: 404
                message: Not Found
                requestId: 11111111-2222-3333-4444-555555555555
                path: <requested-endpoint>
        '409':
          description: Conflict (for some endpoints)
          content:
            application/json:
              example:
                statusCode: 409
                message: Transactions not synced
                requestId: 11111111-2222-3333-4444-555555555555
                path: <requested-endpoint>
        '429':
          description: Too Many Requests
          content:
            application/json:
              example:
                statusCode: 429
                message: Rate limit exceeded
                requestId: 11111111-2222-3333-4444-555555555555
                path: <requested-endpoint>
        '503':
          description: Service Unavailable
          content:
            application/json:
              example:
                statusCode: 503
                message: Service Unavailable. Please Contact Support
        '504':
          description: The RWA upstream request timed out.
      security:
        - X-API-KEY: []
      x-codeSamples:
        - lang: curl
          label: cURL
          source: |-
            curl --request GET \
              --url 'https://api.coinstats.app/v1/rwa/assets/gold/tokens' \
              --header 'X-API-KEY: <api-key>'
        - lang: python
          label: Python
          source: |-
            import requests

            url = "https://api.coinstats.app/v1/rwa/assets/gold/tokens"

            headers = {"X-API-KEY": "<api-key>"}

            response = requests.request("GET", url, headers=headers)

            print(response.json())
        - lang: javascript
          label: JavaScript
          source: >-
            const options = {method: 'GET', headers: {'X-API-KEY':
            '<api-key>'}};


            fetch('https://api.coinstats.app/v1/rwa/assets/gold/tokens',
            options)
              .then((response) => response.json())
              .then((response) => console.log(response))
              .catch((err) => console.error(err));
        - lang: php
          label: PHP
          source: |-
            <?php

            $curl = curl_init();

            curl_setopt_array($curl, [
              CURLOPT_URL => "https://api.coinstats.app/v1/rwa/assets/gold/tokens",
              CURLOPT_RETURNTRANSFER => true,
              CURLOPT_CUSTOMREQUEST => "GET",
              CURLOPT_HTTPHEADER => [
                "X-API-KEY: <api-key>"
              ],
            ]);

            $response = curl_exec($curl);
            $err = curl_error($curl);

            curl_close($curl);

            if ($err) {
              echo "cURL Error #:" . $err;
            } else {
              echo $response;
            }
        - lang: go
          label: Go
          source: "package main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n)\n\nfunc main() {\n\n\turl := \"https://api.coinstats.app/v1/rwa/assets/gold/tokens\"\n\n\treq, _ := http.NewRequest(\"GET\", url, nil)\n\n\treq.Header.Add(\"X-API-KEY\", \"<api-key>\")\n\n\tres, _ := http.DefaultClient.Do(req)\n\n\tdefer res.Body.Close()\n\tbody, _ := io.ReadAll(res.Body)\n\n\tfmt.Println(string(body))\n}"
        - lang: java
          label: Java
          source: >-
            HttpResponse<String> response =
            Unirest.get("https://api.coinstats.app/v1/rwa/assets/gold/tokens")
              .header("X-API-KEY", "<api-key>")
              .asString();
components:
  schemas:
    RwaTokensResponseDto:
      type: object
      properties:
        currency:
          type: string
          example: USD
        updatedAt:
          type: string
          format: date-time
          nullable: true
          description: Publication/section update time, never request time.
        isStale:
          type: boolean
          description: >-
            Whether the upstream publication/section has exceeded its freshness
            threshold.
        available:
          type: boolean
        items:
          type: array
          items:
            $ref: '#/components/schemas/RwaTokenDto'
        pagination:
          $ref: '#/components/schemas/RwaPaginationDto'
        filters:
          $ref: '#/components/schemas/RwaTokenFiltersDto'
      required:
        - currency
        - updatedAt
        - isStale
        - available
        - items
        - pagination
        - filters
    RwaTokenDto:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        symbol:
          type: string
        issuer:
          nullable: true
          type: object
          allOf:
            - $ref: '#/components/schemas/RwaIdNameDto'
        imageUrl:
          type: string
          nullable: true
        coinId:
          type: string
          nullable: true
          description: >-
            CoinStats cryptocurrency ID, present only for a unique current
            mapping. Use with /coins/{coinId}.
        coinSlug:
          type: string
          nullable: true
        networks:
          type: array
          items:
            $ref: '#/components/schemas/RwaNetworkDto'
        price:
          type: number
          nullable: true
          description: Value in the requested currency. Null means unavailable.
        marketCap:
          type: number
          nullable: true
          description: Value in the requested currency. Null means unavailable.
        volume24h:
          type: number
          nullable: true
          description: Value in the requested currency. Null means unavailable.
        change24h:
          type: number
          nullable: true
        marketDataProvider:
          type: string
          nullable: true
          enum:
            - coinstats
      required:
        - id
        - name
        - symbol
        - issuer
        - imageUrl
        - coinId
        - coinSlug
        - networks
        - price
        - marketCap
        - volume24h
        - change24h
        - marketDataProvider
    RwaPaginationDto:
      type: object
      properties:
        page:
          type: number
          example: 1
        limit:
          type: number
          example: 100
          maximum: 100
        total:
          type: number
          example: 20
        totalPages:
          type: number
          example: 1
          minimum: 1
      required:
        - page
        - limit
        - total
        - totalPages
    RwaTokenFiltersDto:
      type: object
      properties:
        issuers:
          type: array
          items:
            $ref: '#/components/schemas/RwaIdNameDto'
        networks:
          example:
            - ethereum
          type: array
          items:
            type: string
      required:
        - issuers
        - networks
    RwaIdNameDto:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
      required:
        - id
        - name
    RwaNetworkDto:
      type: object
      properties:
        platformId:
          type: string
          example: ethereum
        contractAddress:
          type: string
        name:
          type: string
        imageUrl:
          type: string
          nullable: true
        explorerUrl:
          type: string
          nullable: true
      required:
        - platformId
        - contractAddress
        - name
        - imageUrl
        - explorerUrl
  securitySchemes:
    X-API-KEY:
      type: apiKey
      in: header
      name: X-API-KEY
      description: >-
        API key required to access the endpoints. Generate one from your
        dashboard at https://openapi.coinstats.app and pass it in the
        `X-API-KEY` request header. Never expose your key in client-side code.

````

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