{"version":"v1","auth":"Use Authorization: Bearer hq_live_… for member API access, or pay x402 on /api/x402/v1/agent routes. AGENT_API_KEY uses the separate x-agent-key header (not Bearer) for legacy GET and scoped POST /api/chat.","baseUrl":"https://altcoinchasershq.app","endpoints":[{"method":"GET","path":"/api/agent/watchlist/daily","description":"AGENT_API_KEY via x-agent-key only. Current America/New_York day Acai Daily cards with saved exact-contract market observations and normalized factor scores; no live external or paid lookups."},{"method":"POST","path":"/api/chat","description":"Legacy x-agent-key: JSON {content:string, requestId?:UUID, replyToMessageId?:string}. Enqueues a rate-limited Acai reply; 202 {messageId,status} is NOT a reply. Poll GET /api/agent/chat/replies/:messageId for response text or explicit pending/failure."},{"method":"GET","path":"/api/agent/chat/replies/:messageId","description":"Legacy x-agent-key only: returns {messageId,status,response} when a queued reply completes; 202 CHAT_REPLY_PENDING until then, 503 CHAT_REPLY_FAILED for a failed job."},{"method":"GET","path":"/api/v1/agent/market-sentiment","x402Path":"/api/x402/v1/agent/market-sentiment","description":"Cached market sentiment. Costs 1 daily unit with a member key.","price":"$0.01"},{"method":"GET","path":"/api/v1/agent/alpha","x402Path":"/api/x402/v1/agent/alpha","description":"Bounded Acai Alpha signal feed. Costs 1 daily unit with a member key.","price":"$0.08"},{"method":"GET","path":"/api/v1/agent/prediction-markets","x402Path":"/api/x402/v1/agent/prediction-markets","description":"Bounded crypto prediction markets. Costs 1 daily unit with a member key.","price":"$0.05"},{"method":"GET","path":"/api/v1/agent/perps","x402Path":"/api/x402/v1/agent/perps","description":"Bounded Hyperliquid perpetual markets. Costs 1 daily unit with a member key.","price":"$0.05"},{"method":"GET","path":"/api/v1/agent/token-security?chain=eth&address=0x...","x402Path":"/api/x402/v1/agent/token-security?chain=eth&address=0x...","description":"Validated GMGN token security lookup. Costs 3 daily units; maximum 10 daily calls.","price":"$0.05"},{"method":"GET","path":"/api/v1/member/acai-daily","description":"Read-only Acai Daily picks for the member API-key owner. Uses persisted exact-contract snapshots and redacts private notes."},{"method":"GET","path":"/api/v1/member/acai-breakdown","description":"Latest published Acai's Breakdown daily market-intelligence newsletter, scheduled for 9 a.m. America/New_York. Read-only; returns saved content and schedule metadata."},{"method":"GET","path":"/api/v1/member/acai-breakdown/history?limit=7","description":"Recent published Acai's Breakdown newsletters. Read-only; limit defaults to 7 and is capped at 30."},{"method":"GET","path":"/api/v1/member/smart-rotations","description":"Read-only cached Smart Rotation board; wallet addresses and private cluster members are excluded."},{"method":"GET","path":"/api/v1/member/alpha-surge","description":"Read-only Alpha Surge evidence feed with private wallet, contributor, and diagnostic fields removed."},{"method":"GET","path":"/api/v1/member/alpha-launch?minScore=75&cursor=…","description":"Read-only fresh Alpha Launch feed and incremental first-qualification events. minScore is inclusive (score >= minScore), finite 0..100; pass the returned nextCursor unchanged with the same threshold. Events are live launches only (under 120 minutes), exclude watches/history, and include a stable chain:contract eventId plus public score evidence."},{"method":"GET","path":"/api/v1/member/portfolio-updates","description":"Read-only owner-scoped portfolio listings plus persisted portfolio_snapshots rows (up to 100 newest); no write operations."},{"method":"GET","path":"/api/v1/member/portfolio-monitoring","description":"Read-only owner-scoped monitoring using the same news and market-monitoring providers as the browser portfolio monitoring route; no write operations."},{"method":"GET","path":"/api/v1/member/ea-watchlist","description":"Read-only EA watchlist."},{"method":"GET","path":"/api/v1/member/community-watchlist","description":"Read-only shared community watchlist with contributor identity and private notes excluded."},{"method":"GET","path":"/api/v1/member/forensics?chain=solana&address=CONTRACT","description":"Run exact-contract Forensics: market, holders, flows, P&L, liquidity, bundle risks and provider intelligence. Bearer member key required."},{"method":"GET","path":"/api/v1/member/compare?chainA=solana&addressA=CONTRACT_A&chainB=base&addressB=CONTRACT_B","description":"Thorough Acai/Minimax comparison of two exact-contract coins, including structured Forensics reports and explicit data limitations. Bearer member key required."}],"quotas":{"dailyUnits":30,"tokenSecurityDailyCalls":10,"sharedAcrossKeys":true},"x402":{"enabled":true,"status":"Active","setup":"Circle Gateway accepts USDC payments across its supported networks."},"notes":["Legacy GET /api/watchlist?type=acai accepts x-agent-key but performs frontend icon/price enrichment which can take longer. Use /api/agent/watchlist/daily for a bounded social-agent fetch. Neither route is public.","Example: curl -H 'x-agent-key: YOUR_AGENT_API_KEY' 'https://altcoinchasershq.app/api/agent/watchlist/daily' (replace the key locally; never put it in a URL or log).","Chat example: POST /api/chat with Content-Type: application/json, x-agent-key: YOUR_AGENT_API_KEY, body {\"content\":\"What can today's observed Acai Daily evidence support?\"}. Read messageId from 202 and poll /api/agent/chat/replies/{messageId}; never treat a queued acknowledgement as a generated answer. Reuse requestId (UUID) on retries to avoid duplicate work.","Daily watchlist reads are private/no-store and return up to 20 cards; other member endpoints return bounded cached JSON. Poll at most every few minutes.","Alpha Launch polling: GET /api/v1/member/alpha-launch?minScore=75. Scores are inclusive (score >= minScore). The first response includes currently qualifying live launches as events; persist nextCursor and poll with the same minScore and cursor. Each chain:contract eventId is emitted once per cursor when it first qualifies; below-threshold launches are not marked seen, so a later score crossing is delivered. Process/deduplicate events by eventId before saving nextCursor. The cursor is threshold-specific; changing minScore starts a new polling baseline. Only verified launches younger than 120 minutes are eligible; watches and expired launches are excluded.","Member API quota is 30 shared requests per day across endpoints and keys. Hourly Alpha Launch polling uses 24 requests/day and leaves six daily units for other member reads; tune the interval to your remaining quota.","Member quotas are deliberately small to protect shared intelligence-provider budgets.","Forensics: GET /api/v1/member/forensics?chain=solana&address=TOKEN_CONTRACT with Authorization: Bearer YOUR_MEMBER_KEY. Compare: GET /api/v1/member/compare?chainA=solana&addressA=TOKEN_A&chainB=base&addressB=TOKEN_B. Both use one shared daily request unit. Supply exact contracts, not tickers; preserve source dates and unavailable/partial flags. Identical research is reused for five minutes; a 503 response may mean it is still running, so retry the same inputs rather than changing the request."]}