Skip to main content
Get data about RWA tokens across different platforms and networks. For a complete list of available fields, see the Tokens Schema.

​
GET /v4/tokens

Returns a list of tokens with filtering, sorting, and pagination.

​
Example Request

curl -G 'https://api.rwa.xyz/v4/tokens' \
  -H "Authorization: Bearer $RWA_API_KEY" \
  --data-urlencode 'query={
    "sort": { "field": "market_value_dollar", "direction": "desc" },
    "pagination": { "page": 1, "perPage": 5 }
  }'

​
Example Response

{
  "results": [
    {
      "id": 20,
      "name": "Ethereum USYC",
      "asset_id": 51,
      "address": "0x136471a34f6ef19fe...",
      "decimals": 6,
      "standards": ["ERC-20"],
      "network_name": "Ethereum",
      "protocol_name": "Circle",
      "transferability_type": "Transferable within whitelist",
      "market_value_dollar": {
        "val": 2100000000,
        "val_7d": 1950000000,
        "chg_7d_pct": 7.69
      },
      "total_supply_token": { "val": 113140795.54, "val_7d": 109385452.12 },
      "holding_addresses_count": { "val": 342, "val_7d": 335, "chg_7d_pct": 2.09 }
      // ...
    }
  ],
  "pagination": { "page": 1, "perPage": 5, "pageCount": 120, "resultCount": 598 }
}
Numeric metrics are returned as objects with the current value (val), historical snapshots, and percentage changes. See Responses for the full format. For a complete list of fields, see the Tokens Schema.
In the API, platforms are referenced as protocol in field names (e.g., protocol_id, protocol_name) for historical reasons. The terms are interchangeable.

​
GET /v4/tokens/[tokenID]

Returns a single token by ID.

​
Example Request

curl -X GET 'https://api.rwa.xyz/v4/tokens/123' \
  -H "Authorization: Bearer $RWA_API_KEY"

​
GET /v4/tokens/meta

Returns metadata about available fields and filter options.

​
Example Request

curl -X GET "https://api.rwa.xyz/v4/tokens/meta" \
  -H "Authorization: Bearer $RWA_API_KEY"

​
GET /v4/tokens/aggregates

Returns aggregated token data with grouping support.

​
Aggregate GroupBy Options

  • protocol_id
  • network_id
  • asset_class_id
  • asset_id
  • issuer_id
  • date (for timeseries)

​
Example Request

curl -X GET 'https://api.rwa.xyz/v4/tokens/aggregates?query=%7B%22aggregate%22%3A%7B%22groupBy%22%3A%22protocol_id%22%2C%22aggregateFunction%22%3A%22sum%22%7D%7D' \
  -H "Authorization: Bearer $RWA_API_KEY"

​
GET /v4/tokens/aggregates/meta

Returns metadata for the token aggregates endpoint. Use this to discover available measures and filterable fields for timeseries queries.

​
Example Request

curl -X GET "https://api.rwa.xyz/v4/tokens/aggregates/meta" \
  -H "Authorization: Bearer $RWA_API_KEY"

​
GET /v4/tokens/aggregates/timeseries

Returns timeseries data for token aggregates. See the Timeseries & Aggregation guide for a detailed walkthrough of grouping, intervals, and modes.

​
Example Request

curl -X GET 'https://api.rwa.xyz/v4/tokens/aggregates/timeseries?query=%7B%22aggregate%22%3A%7B%22groupBy%22%3A%22date%22%2C%22aggregateFunction%22%3A%22sum%22%2C%22interval%22%3A%22month%22%2C%22mode%22%3A%22stock%22%7D%7D' \
  -H "Authorization: Bearer $RWA_API_KEY"