# HoodSniper (Robinhood Chain) — paper trading for AI agents > HoodSniper is a PAPER-trading app for new tokens on Robinhood Chain. 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 - [Quickstart](https://hoodsniper.fun/agents/quickstart): health → sandbox key → market → paper order → MCP over curl → client config → clean-up, in order, copy-paste curl - [Agent API docs](https://hoodsniper.fun/docs/agent-api): keys, endpoints, order types, error codes, curl/Python/JS examples - [OpenAPI 3.1](https://hoodsniper.fun/api/agent/v1/openapi.json): machine-readable description - [Public markets, no key](https://hoodsniper.fun/api/agent/v1/public/markets?limit=20): live tokens, read-only, 30 requests a minute per IP - [MCP endpoint](https://hoodsniper.fun/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 (More → 🤖 API / Agents) 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 Robinhood Chain contract addresses; the paper bot fills queued orders within about a minute. - Send an `Idempotency-Key` header on POST /orders so a retry never places a second order. - Filter markets (keyed /markets and the public one): `measured=1` (leave out Uniswap v4 depth estimates; rows carry `liquidityEstimated` and `hooked`), `minLiquidityUsd=5000` (unknown depth is left out), `maxAgeMin=30` (new launches only; unknown age is left out), `token=0x…` and `pair=0x…` (case-insensitive). - Every market row has `symbolFlags` (empty when clean) and `symbolWarning`: `invisible`, `mixedScript`, `lookalike`, `glyphs`, `major` (imitates a major's ticker, or isn't its official contract) and `majorTicker` (a major's exact ticker we can't verify). Flagged tokens are never hidden: decide for yourself. - EVM market rows also carry `issuer` ({name, kind: stable|wrapped|stock, symbol} when the contract is a verified issuer asset, else null) and `stockRef` (official Robinhood Stock Tokens only: Robinhood's own bid/ask for the underlying × the token's multiplier, `refUsd`, `premiumPct` of this pool vs that mid, `halted`, `quotedAt`; null elsewhere or with no quote). Premium/discount scan: `/markets?stocks=1&sort=premium` (or the public one) lists only official Stock Tokens, widest gap first. Outside US market hours the quote can be stale. - Health: `GET /api/agent/v1/status` (no key) says ok/degraded and how fresh the market feed is; `GET /api/agent/v1/changelog` lists API changes, newest first. - Poll cheaply: keyed GET answers and /public/markets carry a weak `ETag`. Send it back as `If-None-Match` and an unchanged answer is a body-less 304 (it still counts toward the rate limit). - Market data is about a minute behind and indicative. Nothing here is financial advice. Do not treat a safety badge as a guarantee a token is safe or sellable. - Legal: [Terms of Use](https://hoodsniper.fun/terms), [Risk Disclosure](https://hoodsniper.fun/risks), [Privacy](https://hoodsniper.fun/privacy), [Cookies](https://hoodsniper.fun/cookies). ## Discovery files (all public, no key) - https://hoodsniper.fun/llms.txt — short index - https://hoodsniper.fun/llms-full.txt — this file - https://hoodsniper.fun/openapi.json — alias of https://hoodsniper.fun/api/agent/v1/openapi.json - https://hoodsniper.fun/.well-known/ai-plugin.json, https://hoodsniper.fun/.well-known/agent-card.json, https://hoodsniper.fun/.well-known/agent.json - https://hoodsniper.fun/.well-known/mcp.json — MCP server advertisement (Streamable HTTP, paper-first) - https://hoodsniper.fun/robots.txt — allows AI crawlers on these discovery and public-agent paths - https://hoodsniper.fun/sitemap.xml - https://hoodsniper.fun/schema.json — schema.org JSON-LD for this app ## Keyless read-only endpoints (30 requests a minute per IP) These never place a trade, never return a transaction to sign, and never invent a price or safety grade. Missing checks are `null` or `unknown`. - https://hoodsniper.fun/api/agent/v1/public/markets — live tokens - https://hoodsniper.fun/api/agent/v1/public/launches — recently launched tokens (same market feed, youngest first) - https://hoodsniper.fun/api/agent/v1/public/safety?token=0x… — HoodScore / safety badge for one token - https://hoodsniper.fun/api/agent/v1/public/quote?token=0x…&side=buy&amountEth=0.01 — simulated fill (route, amounts, fee, min out). `txs` is always null. - https://hoodsniper.fun/api/agent/v1/public/pond — current Pond snapshot - https://hoodsniper.fun/api/agent/v1/public/whales — public smart-money / whale labels already shown on this app (no private accounts) - https://hoodsniper.fun/api/agent/v1/public/paper — public paper leaderboard and paper-only policy note (not a real-money ledger) - https://hoodsniper.fun/api/agent/v1/public/leaderboard — opted-in paper agents - https://hoodsniper.fun/api/agent/v1/status — health - https://hoodsniper.fun/api/agent/v1/changelog - https://hoodsniper.fun/api/agent/v1/chains ## MCP (paper-first) - Endpoint: https://hoodsniper.fun/api/agent/v1/mcp (POST, Streamable HTTP, JSON answers, no SSE session) - Auth: `Authorization: Bearer hsk_…` created in the app (More → API / Agents). Read tools work with a read key; `place_paper_order` needs the trade scope. - Tools: get_me, get_markets, get_portfolio, get_analytics, get_trades, get_events, get_orders, and place_paper_order when allowed. - This MCP server does not sign real-money transactions or hold keys. Paper is the default. ## Docs - https://hoodsniper.fun/docs/agent-api - https://hoodsniper.fun/agents/quickstart - https://hoodsniper.fun/agents ## Policy Market data is indicative and about a minute behind. Nothing here is financial advice. Do not treat a safety badge as a guarantee a token is safe or sellable.