Skip to main content
Get data about RWA tokens across different protocols 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 -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 /v4/tokens/[tokenID]

Returns a single token by ID.

​
Example Request

curl -X GET 'https://api.rwa.xyz/v4/tokens/123' \
  -H "Authorization: Bearer YOUR_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 YOUR_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 YOUR_API_KEY"

​
GET /v4/tokens/aggregates/meta

Returns metadata for token aggregates endpoint.

​
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.

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