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

# API Overview

> Rewards REST API — base URL: https://api.rewards.so

Rewards exposes a REST API that lets your applications credit points, read leaderboards, query wallet stats, and surface rewards — all authenticated via API keys scoped to specific point systems.

***

## Quick example

```bash theme={null}
curl https://api.rewards.so/trigger \
  -X POST \
  -H "Authorization: Bearer rw_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "triggerKey": "craft_artifact",
    "walletAddress": "0xabc123...",
    "pointSystemId": "your-point-system-uuid"
  }'
```

```json theme={null}
{
  "success": true,
  "pointsAdded": 10,
  "triggerKey": "craft_artifact",
  "walletAddress": "0xabc123..."
}
```

***

## Endpoints

| Method | Path           | Description                        |
| ------ | -------------- | ---------------------------------- |
| `POST` | `/trigger`     | Credit points via a named trigger  |
| `GET`  | `/leaderboard` | Ranked wallet list with points     |
| `GET`  | `/wallet`      | Stats and rank for a single wallet |
| `GET`  | `/rewards`     | Available and claimed rewards      |
| `GET`  | `/activity`    | Point event history                |

All requests require:

```
Authorization: Bearer rw_your_api_key
```