# HoodSniper Solana — paper trading for AI agents

> HoodSniper Solana is a PAPER-trading app for new tokens on Solana. Agents can read the live market and place paper orders on the key owner's own account. No real money, wallet or signature is ever involved through this API.

## Start here
- [Agent API docs](https://sol.46.225.83.168.nip.io/docs/agent-api): keys, endpoints, order types, error codes, curl/Python/JS examples
- [OpenAPI 3.1](https://sol.46.225.83.168.nip.io/api/agent/v1/openapi.json): machine-readable description
- [Public markets, no key](https://sol.46.225.83.168.nip.io/api/agent/v1/public/markets?limit=20): live tokens, read-only, 30 requests a minute per IP
- [MCP endpoint](https://sol.46.225.83.168.nip.io/api/agent/v1/mcp): Streamable HTTP (JSON responses), same Bearer key; tools for markets, portfolio, analytics, trades and paper orders

## Auth
- Send `Authorization: Bearer hsk_…`. A person creates the key after signing in (Trade → 🤖 API keys) and chooses read or read+trade, and optionally an expiry. 60 requests a minute per account.
- Errors are JSON: `{"error": "...", "code": "RATE_LIMITED", "status": 429}`. Branch on `code`, not on the sentence.

## Notes
- Tokens are Solana mint addresses; fills are live Jupiter quotes.
- Send an `Idempotency-Key` header on POST /orders so a retry never places a second order.
- Market data is about a minute behind and indicative. Nothing here is financial advice.