Skip to main content
Get data about RWA tokens across different protocols and networks.

​
GET /v4/tokens

Returns a list of tokens with filtering, sorting, and pagination. Endpoint: GET /v4/tokens

​
Query Parameters

  • query (optional) - JSON-encoded query object

​
Available Fields for Filtering/Sorting

Identity Fields:
  • id - Token ID
  • name - Token name
  • address - Contract address
  • standard - Token standard (array field)
Relationship Fields:
  • asset_id - Asset ID
  • asset_ticker - Asset ticker symbol
  • asset_name - Asset name
  • network_id - Network ID
  • network_slug - Network slug
  • protocol_id - Protocol ID
  • protocol_slug - Protocol slug
  • base_protocol_id - Base protocol ID
  • base_protocol_slug - Base protocol slug
  • asset_class_id - Asset class ID
  • asset_class_slug - Asset class slug
  • asset_regulatory_framework - Regulatory framework
  • issuer_id - Issuer ID
  • issuer_legal_structure_country_name - Issuer country
Metric Fields (all numeric):
  • market_value_dollar - Market value in USD
  • net_asset_value_dollar - Net asset value in USD
  • total_asset_value_dollar - Total asset value in USD
  • total_supply_token - Total supply in tokens
  • circulating_supply_token - Circulating supply
  • price_dollar - Token price in USD
  • holding_addresses_count - Number of holding addresses
  • daily_active_addresses_count - Daily active addresses
  • monthly_active_addresses_count - Monthly active addresses
  • daily_transfer_volume_dollar - Daily transfer volume
  • daily_mints_dollar - Daily mints in USD
  • daily_burns_dollar - Daily burns in USD
  • available_capacity_dollar - Available capacity
  • maximum_capacity_dollar - Maximum capacity
  • outstanding_principal_dollar - Outstanding principal
  • cumulative_issued_amount_dollar - Cumulative issued amount
  • Plus 80+ additional metrics for lending, transfers, loans, etc.

​
Response Object

Each token object includes: 
{
  "id": "string",
  "name": "string",
  "address": "string",
  "protocol": {
    "id": 1,
    "slug": "ondo",
    "name": "Ondo Finance",
    "color_hex": "#000000",
    "icon_url": "https://...",
    "website": "https://ondo.finance"
  },
  "network": {
    "id": 1,
    "slug": "ethereum",
    "name": "Ethereum",
    "icon_url": "https://...",
    "color_hex": "#627EEA"
  },
  "asset": {
    "id": "...",
    "slug": "us-treasury",
    "name": "US Treasury",
    "ticker": "USDT",
    ...
  },
  "issuer": {
    "id": 1,
    "slug": "ondo",
    "name": "Ondo Finance",
    ...
  },
  "market_value_dollar": { "val": 123456789.50 },
  "total_supply_token": { "val": 100000000 },
  ...
}
Note: Metric values are wrapped in objects with a val key.

​
Example Requests

Get Top 10 Tokens by Market Cap: 
curl -X GET 'https://api.rwa.xyz/v4/tokens?query=%7B%22sort%22%3A%7B%22field%22%3A%22market_value_dollar%22%2C%22direction%22%3A%22desc%22%7D%2C%22pagination%22%3A%7B%22page%22%3A1%2C%22perPage%22%3A10%7D%7D' \
  -H "Authorization: Bearer YOUR_API_KEY"
Query (decoded): 
{
  "sort": {
    "field": "market_value_dollar",
    "direction": "desc"
  },
  "pagination": {
    "page": 1,
    "perPage": 10
  }
}
Get Ethereum Tokens from Ondo Protocol: 
curl -X GET 'https://api.rwa.xyz/v4/tokens?query=%7B%22filter%22%3A%7B%22operator%22%3A%22and%22%2C%22filters%22%3A%5B%7B%22operator%22%3A%22equals%22%2C%22field%22%3A%22protocol_slug%22%2C%22value%22%3A%22ondo%22%7D%2C%7B%22operator%22%3A%22equals%22%2C%22field%22%3A%22network_slug%22%2C%22value%22%3A%22ethereum%22%7D%5D%7D%7D' \
  -H "Authorization: Bearer YOUR_API_KEY"
Query (decoded): 
{
  "filter": {
    "operator": "and",
    "filters": [
      {
        "operator": "equals",
        "field": "protocol_slug",
        "value": "ondo"
      },
      {
        "operator": "equals",
        "field": "network_slug",
        "value": "ethereum"
      }
    ]
  }
}
Get Tokens with Market Cap > $10M: 
curl -X GET 'https://api.rwa.xyz/v4/tokens?query=%7B%22filter%22%3A%7B%22operator%22%3A%22gte%22%2C%22field%22%3A%22market_value_dollar%22%2C%22value%22%3A10000000%7D%7D' \
  -H "Authorization: Bearer YOUR_API_KEY"
Query (decoded): 
{
  "filter": {
    "operator": "gte",
    "field": "market_value_dollar",
    "value": 10000000
  }
}
Search for Tokens by Name: 
curl -X GET 'https://api.rwa.xyz/v4/tokens?query=%7B%22filter%22%3A%7B%22operator%22%3A%22ilike%22%2C%22field%22%3A%22name%22%2C%22value%22%3A%22%25treasury%25%22%7D%7D' \
  -H "Authorization: Bearer YOUR_API_KEY"
Query (decoded): 
{
  "filter": {
    "operator": "ilike",
    "field": "name",
    "value": "%treasury%"
  }
}

​
GET /v4/tokens/meta

Returns metadata about available fields and filter options for the tokens endpoint. Endpoint: GET /v4/tokens/meta

​
Query Parameters

  • filter (optional) - JSON-encoded filter to scope metadata

​
Response

Returns field metadata including:
  • Available fields
  • Field types
  • Allowed operators per field
  • Select options (for enumerated fields)
  • Default values

​
Example Request

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

​
GET /v4/tokens/aggregates

Returns aggregated token data with grouping support. Endpoint: GET /v4/tokens/aggregates

​
Aggregate GroupBy Options

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

​
Example Query

{
  "aggregate": {
    "groupBy": "protocol_id",
    "aggregateFunction": "sum"
  }
}

​
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 YOUR_API_KEY"

​
GET /v4/tokens/aggregates/meta

Returns metadata for token aggregates endpoint. Endpoint: GET /v4/tokens/aggregates/meta

​
Example Request

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

​
GET /v4/tokens/aggregates/timeseries

Returns timeseries data for token aggregates. Endpoint: GET /v4/tokens/aggregates/timeseries

​
Example Query

{
  "filter": {
    "operator": "equals",
    "field": "protocol_slug",
    "value": "centrifuge"
  },
  "aggregate": {
    "groupBy": "date",
    "aggregateFunction": "sum",
    "interval": "month",
    "mode": "stock"
  }
}

​
Example Request

curl -X GET 'https://api.rwa.xyz/v4/tokens/aggregates/timeseries?query=%7B%22filter%22%3A%7B%22operator%22%3A%22equals%22%2C%22field%22%3A%22protocol_slug%22%2C%22value%22%3A%22centrifuge%22%7D%2C%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 YOUR_API_KEY"