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

# Pricing

> Free for reads. From $0.001 per call for agent tools — settled in USDC on Solana via x402.

Pegana does not have tiers. There is a public free read surface and a small set of
agent-targeted paid tools.

## Free — public reads

| Surface        | Limit                                                      | What you get                                                                                                                                                                     |
| -------------- | ---------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| REST API       | \~300 req/min/IP in production (repo default 60/min; soft) | All `/v1/assets/*`, `/v1/alerts`, `/v1/stats`, asset history, `/v1/calibration`, `/v1/methodology/current`, `/v1/audit*`, `/v1/meta/*`. (`/v1/audit.csv` is stricter at 10/min.) |
| WebSocket      | 5 connections/IP                                           | Sub-second push for every state change.                                                                                                                                          |
| Embed widget   | unlimited                                                  | `<iframe>` per asset. \~3 KB HTML, server-rendered 60s cache.                                                                                                                    |
| Telegram bot   | unlimited                                                  | `@PeganaWatchBot`, custom thresholds, English.                                                                                                                                   |
| MCP free tools | unlimited                                                  | `get_assets`, `get_asset_state`, `get_methodology`.                                                                                                                              |

Free means free. No API key. No signup. MIT licensed code, infrastructure self-funded.

## Paid — MCP agent tools (x402)

Two MCP tools cost USDC per call, settled on-chain via [x402](https://x402.org) on Solana mainnet:

| Tool                   | Price               | Use                                                                |
| ---------------------- | ------------------- | ------------------------------------------------------------------ |
| `get_asset_history`    | **\$0.001 / call**  | Historical discount points beyond 24h, 1m / 5m / 15m / 1h buckets. |
| `subscribe_peg_events` | **\$0.0005 / call** | Replay state transitions since a timestamp.                        |

Settlement uses [Coinbase Developer Platform](https://www.coinbase.com/developer-platform)
for the facilitator side and is signed with the wallet you configure in the MCP host.
No subscription, no minimum, no top-up — your wallet is debited per call.

See [MCP paid tools — x402](/docs/guides/mcp-paid-tools-x402) for the full setup, including
how to point your MCP client at a Coinbase CDP wallet.

## What is NOT priced

* **Webhook deliveries** — free during the dogfood window. Once volume justifies, we
  will price by event count, not subscription. Always with the free tier preserved
  for individual / read-only use.
* **Tier names** — we will not invent "Pro / Team / Enterprise" tiers. Pricing exists
  for paid tools; everything else stays free.
* **SLA contracts** — none in v1. Status page at
  [pegana.xyz/status](https://pegana.xyz/status). Reach the operator at
  `raffxweb3@gmail.com` for production discussions.

## Why x402 and not API keys

x402 settles in USDC, on Solana, with the wallet you already trust. There is no
new auth surface to manage, no key rotation, no per-vendor portal. Each call is its
own payment — perfect fit for agent-issued reads where the agent already has a
wallet.

If you want API keys for a server-side workflow, open an issue
([github.com/lrafasouza/pegana-replay/issues](https://github.com/lrafasouza/pegana-replay/issues)).