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

# Authentication

> API key authentication

All endpoints except `/keys` require an API key in the `Authorization` header.

## Get a Key

1. Go to [rwapulse.xyz/api-keys](https://rwapulse.xyz/api-keys)
2. Enter a name, click Create
3. Copy the key immediately (shown once)

## Use the Key

```bash theme={null}
curl "https://rwapulse.xyz/api/v0/liquidity" \
  -H "Authorization: Bearer rwa_your_key"
```

```javascript theme={null}
// JavaScript
const res = await fetch('https://rwapulse.xyz/api/v0/liquidity', {
  headers: { 'Authorization': 'Bearer rwa_your_key' }
});
```

```python theme={null}
# Python
import requests
r = requests.get('https://rwapulse.xyz/api/v0/liquidity',
    headers={'Authorization': 'Bearer rwa_your_key'})
```

## Errors

| Code | Meaning             | Fix                                  |
| ---- | ------------------- | ------------------------------------ |
| 401  | Missing/invalid key | Check `Authorization: Bearer` header |
| 429  | Rate limited        | Wait 60s, retry                      |
| 500  | Server error        | Retry with backoff                   |