> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rwa.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Introduction to the RWA API

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](https://app.rwa.xyz/login) and navigate to the API Tools section: [https://app.rwa.xyz/tools/api/api-keys](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](mailto: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](/schemas/data-model). Each core entity — such as assets, tokens, issuers, networks, and platforms — has a corresponding API endpoint. See the [data model documentation](/schemas/data-model) for details on how these entities relate to each other, or browse the [Data Catalog](https://app.rwa.xyz/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:

| Header                  | Description                                        |
| ----------------------- | -------------------------------------------------- |
| `X-RateLimit-Limit`     | Maximum number of requests allowed in the window   |
| `X-RateLimit-Remaining` | Number of requests remaining in the current window |
| `X-RateLimit-Reset`     | Unix 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:

| Endpoint           | Limit        | Window                    |
| ------------------ | ------------ | ------------------------- |
| `/v4/transactions` | 120 requests | 1 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:

* **Email:** [team@rwa.xyz](mailto:team@rwa.xyz)
* **Documentation:** [https://docs.rwa.xyz](https://docs.rwa.xyz)