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

# x402 alpha API

> x402-style metered API for Perps Agent alpha access.

Perps Agent exposes its alpha signals — proposed grid params, regime tags, attested risk-adjusted scores — through a **metered API** using the `x402` payment standard.

## What `x402` is

`HTTP 402 Payment Required`, revived for the on-chain era. A client hits an endpoint, gets back a `402` with payment instructions (chain, token, amount, recipient), pays on-chain, and replays the request with proof of payment.

* No accounts.
* No API keys.
* No invoicing.
* Just pay-per-call from a wallet.

## Why Perps Agent uses it

* Alpha is **valuable per-call**, not per-month. A per-call price is honest.
* It composes natively with other agents and bots that already speak HTTP + wallets.
* It keeps the proof story consistent: payment is on-chain, just like commits and attestations.

## Endpoints (alpha)

| Endpoint                         | Returns                                         |
| -------------------------------- | ----------------------------------------------- |
| `GET /v1/regime/{market}`        | Current regime tag and confidence.              |
| `GET /v1/propose/{market}`       | A proposed grid config under default risk caps. |
| `GET /v1/attestations/{agentId}` | Recent attested runs and risk-adjusted scores.  |

Full schemas and live pricing land alongside public beta.

<Note>
  `x402` access is for programmatic consumers. The Telegram product does not require it — end users just use the bot.
</Note>