# auth.md - how agents get access to vitalitynode.com

No key is needed to start. Every request is answered the same way with or without a key; a key only raises limits and keeps a history.

## Without a key

- Counted per IP address.
- Official rates (`/api/v1/official/rate`, `/api/v1/official/rates`): 1,000 requests a day, 10 a minute.
- Market prices (`/api/v1/market/quote`): 20 requests a month.
- Above about 60 requests a minute from one IP address, the web server answers 429 with an HTML page.

## With a key

- Get a key: sign in at https://vitalitynode.com/lab/rates/keys/ An agent cannot create a key by itself: ask the user for one.
- Send it as `Authorization: Bearer <key>`.
- Official rates: 10,000 requests a day, 30 a minute; market prices: 100 a month.
- An unknown or revoked key is 401 `invalid_api_key`; a request without the header is anonymous instead.
- Higher limits are set per account on request: https://vitalitynode.com/api/v1/feedback (POST).

## Paying instead of a key

- Above the free limit the API answers `402 Payment Required` with a price in USDC on Base (x402). An agent with an x402 client pays per request, without an account: 0.005 USD above the limit, 0.01 USD for an atlas daily series longer than 60 days. Details: https://vitalitynode.com/api/v1/llms.txt (Paid answers).

## MCP

- Remote MCP server for assistants: https://vitalitynode.com/mcp/rates (Streamable HTTP, read only). No key needed; a key goes in `Authorization: Bearer <key>` and raises the limits as for the HTTP API.

## More

- Full reference for agents: https://vitalitynode.com/api/v1/llms.txt
- OpenAPI schema: https://vitalitynode.com/api/v1/openapi.json
- API catalog (RFC 9727): https://vitalitynode.com/.well-known/api-catalog
