Skip to main content
1

Get an API key

Log in at app.rwa.xyz and go to API Tools > API Keys. Create a key and copy it.If you don’t have access to API Tools, contact team@rwa.xyz.
2

Set your key as an environment variable

export RWA_API_KEY="your_api_key_here"
3

Make your first request

Fetch the top 3 tokenized assets by market value:
curl -G 'https://api.rwa.xyz/v4/assets' \
  -H "Authorization: Bearer $RWA_API_KEY" \
  --data-urlencode 'query={
    "sort": {
      "field": "circulating_market_value_dollar",
      "direction": "desc"
    },
    "pagination": {
      "page": 1,
      "perPage": 3
    }
  }'
4

See the response

{
  "results": [
    {
      "id": 1,
      "name": "USDC",
      "slug": "usdc",
      "ticker": "USDC",
      "asset_class_name": "Stablecoins",
      "issuer_name": "Circle International",
      "circulating_market_value_dollar": {
        "val": 44000000000.00,
        "val_7d": 43500000000.00,
        "chg_7d_pct": 1.15
      },
      "token_count": 16,
      "network_names": ["Ethereum", "Solana", "Avalanche", "Base", "Polygon", "Arbitrum"]
      // ... ~200 fields total per asset
    }
  ],
  "pagination": {
    "page": 1,
    "perPage": 3,
    "pageCount": 112,
    "resultCount": 335
  }
}
Numeric metrics like circulating_market_value_dollar are returned as objects with the current value (val), historical snapshots (val_7d, val_30d), and percentage changes (chg_7d_pct). See Responses for the full format.

​
Next steps

Examples

Walk through every major endpoint and query pattern

Request Reference

Full reference for filters, sorting, pagination, and aggregation

Endpoints

Overview of all available API endpoints

Data Model

How assets, tokens, networks, and platforms relate