{"openapi":"3.1.0","info":{"title":"AltcoinChasersHQ Agent API","version":"1.0.0","description":"Paid, cached crypto market data for agents.","contact":{"email":"altcoinchasercapital@gmail.com"},"x-guidance":"Use a member Bearer key for quota access or x402 aliases for per-call USDC payment. Never send keys in URLs."},"servers":[{"url":"https://altcoinchasershq.app","description":"Production"}],"externalDocs":{"url":"https://altcoinchasershq.app/agents","description":"Agent integration guide"},"paths":{"/api/v1/agent/market-sentiment":{"get":{"summary":"Get market sentiment","description":"Get market sentiment. Responses are bounded cached market data and include source provenance and an as-of timestamp.","security":[{"memberBearer":[]}],"responses":{"200":{"description":"Successful bounded data response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentResponse"}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid member API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"x402 payment required. Decode the PAYMENT-REQUIRED response header to select and authorize one of the offered USDC payment requirements.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 PaymentRequired payload supplied by Circle Gateway.","schema":{"type":"string","contentEncoding":"base64"}}},"content":{"application/json":{"schema":{"type":"object","maxProperties":0}}}},"429":{"description":"Member daily quota exceeded; Retry-After gives seconds to UTC reset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[]}},"/api/x402/v1/agent/market-sentiment":{"get":{"summary":"Pay per call for market sentiment","description":"Pay per call for market sentiment. Responses are bounded cached market data and include source provenance and an as-of timestamp.","security":[{"x402":[]}],"responses":{"200":{"description":"Successful bounded data response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentResponse"}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid member API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"x402 payment required. Decode the PAYMENT-REQUIRED response header to select and authorize one of the offered USDC payment requirements.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 PaymentRequired payload supplied by Circle Gateway.","schema":{"type":"string","contentEncoding":"base64"}}},"content":{"application/json":{"schema":{"type":"object","maxProperties":0}}}},"429":{"description":"Member daily quota exceeded; Retry-After gives seconds to UTC reset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USDC","amount":"0.010000"},"protocols":[{"x402":{}}]},"parameters":[]}},"/api/v1/agent/token-security":{"get":{"summary":"Get token security","description":"Get token security. Responses are bounded cached market data and include source provenance and an as-of timestamp.","security":[{"memberBearer":[]}],"responses":{"200":{"description":"Successful bounded data response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentResponse"}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid member API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"x402 payment required. Decode the PAYMENT-REQUIRED response header to select and authorize one of the offered USDC payment requirements.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 PaymentRequired payload supplied by Circle Gateway.","schema":{"type":"string","contentEncoding":"base64"}}},"content":{"application/json":{"schema":{"type":"object","maxProperties":0}}}},"429":{"description":"Member daily quota exceeded; Retry-After gives seconds to UTC reset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"chain","in":"query","required":true,"description":"Supported chain: sol, bsc, base, eth, or robinhood.","schema":{"type":"string"}},{"name":"address","in":"query","required":true,"description":"Solana base58 mint or EVM 0x contract address.","schema":{"type":"string"}}]}},"/api/x402/v1/agent/token-security":{"get":{"summary":"Pay per call for token security","description":"Pay per call for token security. Responses are bounded cached market data and include source provenance and an as-of timestamp.","security":[{"x402":[]}],"responses":{"200":{"description":"Successful bounded data response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentResponse"}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid member API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"x402 payment required. Decode the PAYMENT-REQUIRED response header to select and authorize one of the offered USDC payment requirements.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 PaymentRequired payload supplied by Circle Gateway.","schema":{"type":"string","contentEncoding":"base64"}}},"content":{"application/json":{"schema":{"type":"object","maxProperties":0}}}},"429":{"description":"Member daily quota exceeded; Retry-After gives seconds to UTC reset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USDC","amount":"0.050000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"chain","in":"query","required":true,"description":"Supported chain: sol, bsc, base, eth, or robinhood.","schema":{"type":"string"}},{"name":"address","in":"query","required":true,"description":"Solana base58 mint or EVM 0x contract address.","schema":{"type":"string"}}]}},"/api/v1/agent/alpha":{"get":{"summary":"Get alpha","description":"Get alpha. Responses are bounded cached market data and include source provenance and an as-of timestamp.","security":[{"memberBearer":[]}],"responses":{"200":{"description":"Successful bounded data response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentResponse"}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid member API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"x402 payment required. Decode the PAYMENT-REQUIRED response header to select and authorize one of the offered USDC payment requirements.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 PaymentRequired payload supplied by Circle Gateway.","schema":{"type":"string","contentEncoding":"base64"}}},"content":{"application/json":{"schema":{"type":"object","maxProperties":0}}}},"429":{"description":"Member daily quota exceeded; Retry-After gives seconds to UTC reset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[]}},"/api/x402/v1/agent/alpha":{"get":{"summary":"Pay per call for alpha","description":"Pay per call for alpha. Responses are bounded cached market data and include source provenance and an as-of timestamp.","security":[{"x402":[]}],"responses":{"200":{"description":"Successful bounded data response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentResponse"}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid member API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"x402 payment required. Decode the PAYMENT-REQUIRED response header to select and authorize one of the offered USDC payment requirements.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 PaymentRequired payload supplied by Circle Gateway.","schema":{"type":"string","contentEncoding":"base64"}}},"content":{"application/json":{"schema":{"type":"object","maxProperties":0}}}},"429":{"description":"Member daily quota exceeded; Retry-After gives seconds to UTC reset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USDC","amount":"0.080000"},"protocols":[{"x402":{}}]},"parameters":[]}},"/api/v1/agent/prediction-markets":{"get":{"summary":"Get prediction markets","description":"Get prediction markets. Responses are bounded cached market data and include source provenance and an as-of timestamp.","security":[{"memberBearer":[]}],"responses":{"200":{"description":"Successful bounded data response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentResponse"}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid member API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"x402 payment required. Decode the PAYMENT-REQUIRED response header to select and authorize one of the offered USDC payment requirements.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 PaymentRequired payload supplied by Circle Gateway.","schema":{"type":"string","contentEncoding":"base64"}}},"content":{"application/json":{"schema":{"type":"object","maxProperties":0}}}},"429":{"description":"Member daily quota exceeded; Retry-After gives seconds to UTC reset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[]}},"/api/x402/v1/agent/prediction-markets":{"get":{"summary":"Pay per call for prediction markets","description":"Pay per call for prediction markets. Responses are bounded cached market data and include source provenance and an as-of timestamp.","security":[{"x402":[]}],"responses":{"200":{"description":"Successful bounded data response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentResponse"}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid member API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"x402 payment required. Decode the PAYMENT-REQUIRED response header to select and authorize one of the offered USDC payment requirements.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 PaymentRequired payload supplied by Circle Gateway.","schema":{"type":"string","contentEncoding":"base64"}}},"content":{"application/json":{"schema":{"type":"object","maxProperties":0}}}},"429":{"description":"Member daily quota exceeded; Retry-After gives seconds to UTC reset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USDC","amount":"0.050000"},"protocols":[{"x402":{}}]},"parameters":[]}},"/api/v1/agent/perps":{"get":{"summary":"Get perps","description":"Get perps. Responses are bounded cached market data and include source provenance and an as-of timestamp.","security":[{"memberBearer":[]}],"responses":{"200":{"description":"Successful bounded data response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentResponse"}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid member API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"x402 payment required. Decode the PAYMENT-REQUIRED response header to select and authorize one of the offered USDC payment requirements.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 PaymentRequired payload supplied by Circle Gateway.","schema":{"type":"string","contentEncoding":"base64"}}},"content":{"application/json":{"schema":{"type":"object","maxProperties":0}}}},"429":{"description":"Member daily quota exceeded; Retry-After gives seconds to UTC reset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[]}},"/api/x402/v1/agent/perps":{"get":{"summary":"Pay per call for perps","description":"Pay per call for perps. Responses are bounded cached market data and include source provenance and an as-of timestamp.","security":[{"x402":[]}],"responses":{"200":{"description":"Successful bounded data response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentResponse"}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing or invalid member API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"x402 payment required. Decode the PAYMENT-REQUIRED response header to select and authorize one of the offered USDC payment requirements.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 PaymentRequired payload supplied by Circle Gateway.","schema":{"type":"string","contentEncoding":"base64"}}},"content":{"application/json":{"schema":{"type":"object","maxProperties":0}}}},"429":{"description":"Member daily quota exceeded; Retry-After gives seconds to UTC reset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USDC","amount":"0.050000"},"protocols":[{"x402":{}}]},"parameters":[]}},"/api/v1/member/acai-daily":{"get":{"summary":"Get Acai Daily picks","description":"Acai Daily picks. Read-only member API-key access with private no-store responses; private notes, contributor identities, wallet addresses, and diagnostics are excluded where applicable.","security":[{"memberBearer":[]}],"responses":{"200":{"description":"Successful response"},"401":{"description":"Missing or invalid member API key"},"403":{"description":"Paid membership required"},"429":{"description":"Member daily quota exceeded"}}}},"/api/v1/member/acai-breakdown":{"get":{"summary":"Get Acai's Breakdown newsletter","description":"Acai's Breakdown newsletter. Read-only member API-key access with private no-store responses; private notes, contributor identities, wallet addresses, and diagnostics are excluded where applicable.","security":[{"memberBearer":[]}],"responses":{"200":{"description":"Successful response"},"401":{"description":"Missing or invalid member API key"},"403":{"description":"Paid membership required"},"429":{"description":"Member daily quota exceeded"}}}},"/api/v1/member/acai-breakdown/history":{"get":{"summary":"Get recent Acai's Breakdown newsletters","description":"recent Acai's Breakdown newsletters. Read-only member API-key access with private no-store responses; private notes, contributor identities, wallet addresses, and diagnostics are excluded where applicable.","parameters":[{"name":"limit","in":"query","required":false,"description":"Number of recent published newsletters (default 7, maximum 30).","schema":{"type":"integer","minimum":1,"maximum":30,"default":7}}],"security":[{"memberBearer":[]}],"responses":{"200":{"description":"Successful response"},"401":{"description":"Missing or invalid member API key"},"403":{"description":"Paid membership required"},"429":{"description":"Member daily quota exceeded"}}}},"/api/v1/member/smart-rotations":{"get":{"summary":"Get Smart Rotations","description":"Smart Rotations. Read-only member API-key access with private no-store responses; private notes, contributor identities, wallet addresses, and diagnostics are excluded where applicable.","security":[{"memberBearer":[]}],"responses":{"200":{"description":"Successful response"},"401":{"description":"Missing or invalid member API key"},"403":{"description":"Paid membership required"},"429":{"description":"Member daily quota exceeded"}}}},"/api/v1/member/alpha-surge":{"get":{"summary":"Get Alpha Surge","description":"Alpha Surge. Read-only member API-key access with private no-store responses; private notes, contributor identities, wallet addresses, and diagnostics are excluded where applicable.","security":[{"memberBearer":[]}],"responses":{"200":{"description":"Successful response"},"401":{"description":"Missing or invalid member API key"},"403":{"description":"Paid membership required"},"429":{"description":"Member daily quota exceeded"}}}},"/api/v1/member/alpha-launch":{"get":{"summary":"Get fresh Alpha Launches and incremental qualification events","description":"Read-only cached Alpha Launch feed and incremental qualification events. minScore is inclusive (score >= minScore), finite 0..100. The first request returns currently qualifying launches as events; save nextCursor and pass it unchanged with the same minScore on each poll. Events carry a stable chain:contract eventId and only include verified launches younger than 120 minutes; watches/history are excluded. Below-threshold contracts remain eligible to emit once if they later cross the threshold.","parameters":[{"name":"minScore","in":"query","required":false,"description":"Inclusive minimum Alpha Launch score; rows with score >= minScore qualify. Finite 0..100; defaults to 0.","schema":{"type":"number","minimum":0,"maximum":100,"default":0}},{"name":"cursor","in":"query","required":false,"description":"Opaque nextCursor from the prior response. Keep the same minScore; use eventId to deduplicate if retrying.","schema":{"type":"string"}}],"security":[{"memberBearer":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Invalid minScore or malformed/threshold-mismatched cursor"},"401":{"description":"Missing or invalid member API key"},"403":{"description":"Paid membership required"},"429":{"description":"Member daily quota exceeded"},"503":{"description":"Fresh stored Alpha Launch data is temporarily unavailable"}}}},"/api/v1/member/portfolio-updates":{"get":{"summary":"Get owned portfolio updates","description":"owned portfolio updates. Read-only member API-key access with private no-store responses; private notes, contributor identities, wallet addresses, and diagnostics are excluded where applicable.","security":[{"memberBearer":[]}],"responses":{"200":{"description":"Successful response"},"401":{"description":"Missing or invalid member API key"},"403":{"description":"Paid membership required"},"429":{"description":"Member daily quota exceeded"}}}},"/api/v1/member/portfolio-monitoring":{"get":{"summary":"Get owned portfolio monitoring","description":"owned portfolio monitoring. Read-only member API-key access with private no-store responses; private notes, contributor identities, wallet addresses, and diagnostics are excluded where applicable.","security":[{"memberBearer":[]}],"responses":{"200":{"description":"Successful response"},"401":{"description":"Missing or invalid member API key"},"403":{"description":"Paid membership required"},"429":{"description":"Member daily quota exceeded"}}}},"/api/v1/member/ea-watchlist":{"get":{"summary":"Get EA watchlist","description":"EA watchlist. Read-only member API-key access with private no-store responses; private notes, contributor identities, wallet addresses, and diagnostics are excluded where applicable.","security":[{"memberBearer":[]}],"responses":{"200":{"description":"Successful response"},"401":{"description":"Missing or invalid member API key"},"403":{"description":"Paid membership required"},"429":{"description":"Member daily quota exceeded"}}}},"/api/v1/member/community-watchlist":{"get":{"summary":"Get shared community watchlist","description":"shared community watchlist. Read-only member API-key access with private no-store responses; private notes, contributor identities, wallet addresses, and diagnostics are excluded where applicable.","security":[{"memberBearer":[]}],"responses":{"200":{"description":"Successful response"},"401":{"description":"Missing or invalid member API key"},"403":{"description":"Paid membership required"},"429":{"description":"Member daily quota exceeded"}}}},"/api/v1/member/forensics":{"get":{"summary":"Get exact-contract Forensics report","description":"exact-contract Forensics report. Read-only member API-key access with private no-store responses; private notes, contributor identities, wallet addresses, and diagnostics are excluded where applicable.","parameters":[{"name":"chain","in":"query","required":true,"schema":{"type":"string"},"description":"Supported chain: solana, ethereum, base, arbitrum, optimism, polygon, bsc, avalanche, robinhood."},{"name":"address","in":"query","required":true,"schema":{"type":"string"},"description":"Exact token contract on the corresponding chain."}],"security":[{"memberBearer":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Invalid chain/contract, or identical comparison inputs"},"401":{"description":"Missing or invalid member API key"},"403":{"description":"Paid membership required"},"404":{"description":"Exact contract could not be resolved on its requested chain"},"429":{"description":"Member daily quota exceeded"},"503":{"description":"Research is still running or capacity is temporarily unavailable; retry the same inputs"}}}},"/api/v1/member/compare":{"get":{"summary":"Get thorough two-coin Acai comparison","description":"thorough two-coin Acai comparison. Read-only member API-key access with private no-store responses; private notes, contributor identities, wallet addresses, and diagnostics are excluded where applicable.","parameters":[{"name":"chainA","in":"query","required":true,"schema":{"type":"string"},"description":"Supported chain: solana, ethereum, base, arbitrum, optimism, polygon, bsc, avalanche, robinhood."},{"name":"addressA","in":"query","required":true,"schema":{"type":"string"},"description":"Exact token contract on the corresponding chain."},{"name":"chainB","in":"query","required":true,"schema":{"type":"string"},"description":"Supported chain: solana, ethereum, base, arbitrum, optimism, polygon, bsc, avalanche, robinhood."},{"name":"addressB","in":"query","required":true,"schema":{"type":"string"},"description":"Exact token contract on the corresponding chain."}],"security":[{"memberBearer":[]}],"responses":{"200":{"description":"Successful response"},"400":{"description":"Invalid chain/contract, or identical comparison inputs"},"401":{"description":"Missing or invalid member API key"},"403":{"description":"Paid membership required"},"404":{"description":"Exact contract could not be resolved on its requested chain"},"429":{"description":"Member daily quota exceeded"},"503":{"description":"Research is still running or capacity is temporarily unavailable; retry the same inputs"}}}}},"components":{"securitySchemes":{"memberBearer":{"type":"http","scheme":"bearer","bearerFormat":"hq_live API key","description":"Paid member API key."},"x402":{"type":"http","scheme":"x402","description":"Circle Gateway USDC payment."}},"schemas":{"AgentResponse":{"type":"object","required":["data","provenance","asOf"],"properties":{"data":{"description":"Endpoint-specific bounded market data.","type":"object"},"provenance":{"description":"Human-readable upstream source attribution.","type":"string"},"asOf":{"description":"ISO-8601 time at which this data was produced or observed.","type":"string","format":"date-time"}}},"Error":{"type":"object","required":["message"],"properties":{"message":{"description":"Machine-readable error explanation.","type":"string"},"retryAfter":{"description":"Seconds until the UTC quota reset when rate limited.","type":"integer"}}}}}}