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

# Quickstart

> Make your first API call in under 2 minutes

<Steps>
  <Step title="Get an API key">
    Log in at [app.rwa.xyz](https://app.rwa.xyz/login) and go to [API Tools > API Keys](https://app.rwa.xyz/tools/api/api-keys). Create a key and copy it.

    If you don't have access to API Tools, contact [team@rwa.xyz](mailto:team@rwa.xyz).
  </Step>

  <Step title="Set your key as an environment variable">
    ```bash theme={null}
    export RWA_API_KEY="your_api_key_here"
    ```
  </Step>

  <Step title="Make your first request">
    Fetch the top 3 tokenized assets by market value:

    ```bash theme={null}
    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
        }
      }'
    ```
  </Step>

  <Step title="See the response">
    ```json theme={null}
    {
      "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](/api/responses#metric-objects) for the full format.
  </Step>
</Steps>

## Next steps

<CardGroup cols={2}>
  <Card title="Examples" icon="code" href="/api/examples">
    Walk through every major endpoint and query pattern
  </Card>

  <Card title="Request Reference" icon="book" href="/api/requests">
    Full reference for filters, sorting, pagination, and aggregation
  </Card>

  <Card title="Endpoints" icon="server" href="/api/endpoints">
    Overview of all available API endpoints
  </Card>

  <Card title="Data Model" icon="diagram-project" href="/schemas/data-model">
    How assets, tokens, networks, and platforms relate
  </Card>
</CardGroup>