Skip to main content
The RWA API provides programmatic access to Real World Asset (RWA) data including tokens, platforms, networks, and market metrics. The API is built on a flexible query system that allows filtering, sorting, pagination, and aggregation.

Base URL

Production: https://api.rwa.xyz All endpoints are versioned. The current version is v4.

Obtaining an API Key

Login to your account at https://app.rwa.xyz/login and navigate to the API Tools section: https://app.rwa.xyz/tools/api/api-keys. If you do not have access to the API Tools section, contact us at team@rwa.xyz to request access. Enter a name for your API key and click “Create API Key”.

Data Model

The API is organized around the RWA.xyz data model. Each core entity — such as assets, tokens, issuers, networks, and platforms — has a corresponding API endpoint. See the data model documentation for details on how these entities relate to each other, or browse the Data Catalog to explore all available entities, fields, and measures.

Caching

API responses are cached for 30 minutes (1800 seconds) to improve performance. Cache headers are included in responses:
Cache-Control: s-maxage=1800

Rate Limits

The API uses a sliding window rate limiter. When rate limits apply, responses include the following headers:
HeaderDescription
X-RateLimit-LimitMaximum number of requests allowed in the window
X-RateLimit-RemainingNumber of requests remaining in the current window
X-RateLimit-ResetUnix timestamp when the rate limit window resets
If you exceed the rate limit, the API returns a 429 Too Many Requests response. Back off and retry after the time indicated by X-RateLimit-Reset. Currently, the following endpoints have rate limits:
EndpointLimitWindow
/v4/transactions120 requests1 hour (per organization)
Rate limits may be added to additional endpoints in the future. Always check the X-RateLimit-* headers in your responses to handle limits gracefully.

Support

For API support, questions, or to report issues: