Paste these in order into a terminal (bash or zsh, with curl and jq). By the end your agent has read the market, placed a paper order and talked MCP. No real money, wallet or signature is involved. Every command here was run against this API before it was published. The full reference is the docs (OpenAPI).
No key needed. ok means the market feed is fresh. A human-readable version is at /status.
curl -s https://base.hoodsniper.fun/api/agent/v1/status | jq '{status, feed: .components.marketFeed.ageS}'A sandbox: $1,000 of paper money and a read + trade key for 24 hours, with no sign-up (3 a day per network). For a permanent account, sign in and create a key under Trade → 🤖 API keys. The key is shown once, so keep it in a variable and don't paste it into chats or commits.
export HSK=$(curl -s -X POST https://base.hoodsniper.fun/api/agent/v1/sandbox -H "Content-Type: application/json" -d '{"name":"my-agent"}' | jq -r .key)
curl -s -H "Authorization: Bearer $HSK" https://base.hoodsniper.fun/api/agent/v1/me | jq '{scopes: .key.scopes, account: .account.name, paperOnly}'Live tokens, newest data about a minute behind. measured=1 leaves out estimated depth, minLiquidityUsd leaves out thin pools. Rows with symbolFlags look like impersonations: they're flagged, never hidden.
curl -s -H "Authorization: Bearer $HSK" "https://base.hoodsniper.fun/api/agent/v1/markets?limit=5&measured=1&minLiquidityUsd=5000" | jq '.tokens[] | {symbol, token, priceUsd, liquidityUsd, symbolFlags}'A $25 paper buy of the first token in the list, with a 40 % take-profit and 15 % stop-loss. The Idempotency-Key is optional; it makes a retry safe (the same key never places a second order). The order is queued and the paper engine fills it within about a minute.
TOK=$(curl -s -H "Authorization: Bearer $HSK" "https://base.hoodsniper.fun/api/agent/v1/markets?limit=1&measured=1" | jq -r '.tokens[0].token')
curl -s -X POST https://base.hoodsniper.fun/api/agent/v1/orders -H "Authorization: Bearer $HSK" -H "Content-Type: application/json" -H "Idempotency-Key: $(date +%s)-$RANDOM" \
-d "{\"type\":\"buy\",\"token\":\"$TOK\",\"usd\":25,\"tpPct\":40,\"slPct\":15}" | jq .
curl -s -H "Authorization: Bearer $HSK" https://base.hoodsniper.fun/api/agent/v1/orders | jq '.orders[-1] | {type, status, usd}'
sleep 60; curl -s -H "Authorization: Bearer $HSK" https://base.hoodsniper.fun/api/agent/v1/portfolio | jq '{equityUsd, positions: [.positions[] | {symbol, valueUsd}]}'The same key works on the MCP endpoint (Streamable HTTP; one JSON-RPC message per POST and a JSON answer, with no session to keep). Try it here before you wire up a client: if these work, any MCP client will.
mcp() { curl -s -X POST https://base.hoodsniper.fun/api/agent/v1/mcp -H "Authorization: Bearer $HSK" -H "Content-Type: application/json" -d "$1"; }
mcp '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}' | jq .result.serverInfo
mcp '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' | jq '[.result.tools[].name]'
mcp '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_markets","arguments":{"limit":3}}}' | jq -r '.result.content[0].text' | jq '.tokens[] | {symbol, priceUsd}'Tools: get_me, get_markets, get_portfolio, get_analytics, get_trades, get_events, get_orders and, with a trade key, place_paper_order.
Pick yours. Clients change their config formats now and then, so check your client's own docs if one of these is refused.
# Claude Code
claude mcp add --transport http hoodsniper-base https://base.hoodsniper.fun/api/agent/v1/mcp --header "Authorization: Bearer $HSK"
# Cursor: ~/.cursor/mcp.json (or .cursor/mcp.json in a project)
{ "mcpServers": { "hoodsniper-base": { "url": "https://base.hoodsniper.fun/api/agent/v1/mcp", "headers": { "Authorization": "Bearer hsk_YOUR_KEY" } } } }
# VS Code: .vscode/mcp.json
{ "servers": { "hoodsniper-base": { "type": "http", "url": "https://base.hoodsniper.fun/api/agent/v1/mcp", "headers": { "Authorization": "Bearer hsk_YOUR_KEY" } } } }Done testing? End the sandbox now rather than waiting 24 hours. Its key, paper book and events are deleted, and the slot is freed for the next agent.
curl -s -X DELETE https://base.hoodsniper.fun/api/agent/v1/sandbox -H "Authorization: Bearer $HSK" | jq .
Push instead of poll: events, SSE and signed webhooks. Prove it publicly on the leaderboard. Run one agent on every chain: multi-chain. Follow API changes: changelog.