{"openapi":"3.1.0","info":{"title":"AIM Network - Autonomous M2M API Hub","description":"Autonomous Machine-to-Machine (M2M) Data & Quantitative Intelligence Hub. Pay per request via HTTP 402 (x402 protocol) in USDC on Base Mainnet (Chain ID 8453).","version":"1.1.0","x-payment-protocol":"x402","x-payment-network":"base-mainnet","x-payment-chain-id":8453,"x-payment-token":"USDC","x-payment-contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","x-payment-recipient":"0x1bbae07abebbb61f611391e02e81ee26b0c47b79","x-payment-facilitator":"https://facilitator.payai.network"},"paths":{"/api/admin/login":{"post":{"tags":["Overseer Dashboard & Admin"],"summary":"Admin Login","description":"Exchange the admin PIN for a signed HttpOnly session cookie (lockout-protected).","operationId":"admin_login_api_admin_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/logout":{"post":{"tags":["Overseer Dashboard & Admin"],"summary":"Admin Logout","operationId":"admin_logout_api_admin_logout_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/admin/stats":{"get":{"tags":["Overseer Dashboard & Admin"],"summary":"Admin Stats Endpoint","description":"Return live stats, scout discoveries, traffic telemetry, and wallet info (PIN-protected).","operationId":"admin_stats_endpoint_api_admin_stats_get","parameters":[{"name":"X-Admin-Pin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Pin"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Admin Stats Endpoint Api Admin Stats Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/toggle-pause":{"post":{"tags":["Overseer Dashboard & Admin"],"summary":"Toggle Emergency Stop","description":"Toggle or set the Emergency Stop state (PIN-protected with brute-force lockout).","operationId":"toggle_emergency_stop_api_admin_toggle_pause_post","parameters":[{"name":"X-Admin-Pin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Pin"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/PauseToggleRequest"},{"type":"null"}],"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Toggle Emergency Stop Api Admin Toggle Pause Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/toggle-mode":{"post":{"tags":["Overseer Dashboard & Admin"],"summary":"Toggle Verify Mode","description":"Switch between 'hybrid' and 'strict_onchain' (PIN-protected with brute-force lockout).","operationId":"toggle_verify_mode_api_admin_toggle_mode_post","parameters":[{"name":"X-Admin-Pin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Pin"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ModeToggleRequest"},{"type":"null"}],"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Toggle Verify Mode Api Admin Toggle Mode Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/backup-snapshot":{"get":{"tags":["Overseer Dashboard & Admin"],"summary":"Get Backup Snapshot","description":"Export sanitized SQLite snapshot (IPs and payer addresses are redacted). Protected by X-Scout-Token or X-Admin-Pin.","operationId":"get_backup_snapshot_api_admin_backup_snapshot_get","parameters":[{"name":"X-Admin-Pin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Pin"}},{"name":"X-Scout-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Scout-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Backup Snapshot Api Admin Backup Snapshot Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/restore-snapshot":{"post":{"tags":["Overseer Dashboard & Admin"],"summary":"Restore Backup Snapshot","description":"Restore/merge SQLite snapshot if container restarted (requires auth token).","operationId":"restore_backup_snapshot_api_admin_restore_snapshot_post","parameters":[{"name":"X-Admin-Pin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Pin"}},{"name":"X-Scout-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Scout-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Snapshot"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Restore Backup Snapshot Api Admin Restore Snapshot Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/preview-product":{"get":{"tags":["Overseer Dashboard & Admin"],"summary":"Preview Product Payload","description":"Inspect the exact live JSON product a buying AI-bot receives (PIN-protected, else it bypasses the paywall).","operationId":"preview_product_payload_api_admin_preview_product_get","parameters":[{"name":"endpoint","in":"query","required":false,"schema":{"type":"string","default":"/api/v1/crypto-pulse","title":"Endpoint"}},{"name":"X-Admin-Pin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Pin"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Preview Product Payload Api Admin Preview Product Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/self-check":{"get":{"tags":["Overseer Dashboard & Admin"],"summary":"Run Agent Self Diagnosis","description":"Run a live health check on all 4 autonomous subsystems/agents (PIN-protected).","operationId":"run_agent_self_diagnosis_api_admin_self_check_get","parameters":[{"name":"X-Admin-Pin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Pin"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Run Agent Self Diagnosis Api Admin Self Check Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/simulate-purchase":{"post":{"tags":["Overseer Dashboard & Admin"],"summary":"Simulate Admin Purchase","description":"Admin-only 1-click purchase simulator:\nRecords a simulated $0.01 USDC purchase on /api/v1/crypto-pulse, logs the 402 -> 200\nconversion funnel in Traffic Radar, and returns the unlocked product payload.\nCan be wiped anytime via POST /api/admin/reset-simulations.","operationId":"simulate_admin_purchase_api_admin_simulate_purchase_post","parameters":[{"name":"X-Admin-Pin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Pin"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Simulate Admin Purchase Api Admin Simulate Purchase Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/reset-simulations":{"post":{"tags":["Overseer Dashboard & Admin"],"summary":"Reset Admin Simulations","description":"Remove all admin-simulated test purchases so revenue counters show only real on-chain sales.","operationId":"reset_admin_simulations_api_admin_reset_simulations_post","parameters":[{"name":"X-Admin-Pin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Pin"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Reset Admin Simulations Api Admin Reset Simulations Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/clear-traffic":{"post":{"tags":["Overseer Dashboard & Admin"],"summary":"Clear Admin Traffic Logs","description":"Clear all traffic_logs so only fresh external bot visits are shown.","operationId":"clear_admin_traffic_logs_api_admin_clear_traffic_post","parameters":[{"name":"X-Admin-Pin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Pin"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Clear Admin Traffic Logs Api Admin Clear Traffic Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/traffic":{"get":{"tags":["Overseer Dashboard & Admin"],"summary":"Admin Get Traffic Logs","description":"Paginated, searchable traffic log feed with visitor filter support.","operationId":"admin_get_traffic_logs_api_admin_traffic_get","parameters":[{"name":"search","in":"query","required":false,"schema":{"type":"string","default":"","title":"Search"}},{"name":"filter","in":"query","required":false,"schema":{"type":"string","default":"ALL","title":"Filter"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Page Size"}},{"name":"X-Admin-Pin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Pin"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Admin Get Traffic Logs Api Admin Traffic Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/visitor-journey":{"get":{"tags":["Overseer Dashboard & Admin"],"summary":"Admin Get Visitor Journey","description":"Return chronological clickstream/journey for an individual bot or visitor session.","operationId":"admin_get_visitor_journey_api_admin_visitor_journey_get","parameters":[{"name":"visitor_id","in":"query","required":true,"schema":{"type":"string","title":"Visitor Id"}},{"name":"X-Admin-Pin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Pin"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Admin Get Visitor Journey Api Admin Visitor Journey Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin":{"get":{"tags":["Overseer Dashboard & Admin"],"summary":"Admin Dashboard Portal","description":"Dedicated Admin Portal (supports ?pin=XXXX or session cookie login).","operationId":"admin_dashboard_portal_admin_head","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}},"head":{"tags":["Overseer Dashboard & Admin"],"summary":"Admin Dashboard Portal","description":"Dedicated Admin Portal (supports ?pin=XXXX or session cookie login).","operationId":"admin_dashboard_portal_admin_head","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/":{"get":{"tags":["Overseer Dashboard & Admin"],"summary":"Root Entrypoint","description":"Public Entrypoint for AIM Network:\n- Returns JSON machine discovery manifest when requested with Accept: application/json or ?format=json.\n- If user has active admin session, renders Overseer Dashboard.\n- Otherwise, renders high-converting public landing page for human visitors and web agents.","operationId":"root_entrypoint__head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"head":{"tags":["Overseer Dashboard & Admin"],"summary":"Root Entrypoint","description":"Public Entrypoint for AIM Network:\n- Returns JSON machine discovery manifest when requested with Accept: application/json or ?format=json.\n- If user has active admin session, renders Overseer Dashboard.\n- Otherwise, renders high-converting public landing page for human visitors and web agents.","operationId":"root_entrypoint__head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/llms.txt":{"get":{"tags":["AI Discovery & Autonomous Scout"],"summary":"Llms Txt Manifest","description":"Machine-readable Markdown manifest for LLM crawlers and autonomous buying agents.","operationId":"llms_txt_manifest_llms_txt_head","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}},"head":{"tags":["AI Discovery & Autonomous Scout"],"summary":"Llms Txt Manifest","description":"Machine-readable Markdown manifest for LLM crawlers and autonomous buying agents.","operationId":"llms_txt_manifest_llms_txt_head","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/robots.txt":{"get":{"tags":["AI Discovery & Autonomous Scout"],"summary":"Robots Txt","description":"Explicitly invite all AI search crawlers, M2M agents, and indexers.","operationId":"robots_txt_robots_txt_head","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}},"head":{"tags":["AI Discovery & Autonomous Scout"],"summary":"Robots Txt","description":"Explicitly invite all AI search crawlers, M2M agents, and indexers.","operationId":"robots_txt_robots_txt_head","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/sitemap.xml":{"get":{"tags":["AI Discovery & Autonomous Scout"],"summary":"Sitemap Xml","description":"Dynamic XML sitemap for search engines and AI directory crawlers.","operationId":"sitemap_xml_sitemap_xml_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"head":{"tags":["AI Discovery & Autonomous Scout"],"summary":"Sitemap Xml","description":"Dynamic XML sitemap for search engines and AI directory crawlers.","operationId":"sitemap_xml_sitemap_xml_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/agents.json":{"get":{"tags":["AI Discovery & Autonomous Scout"],"summary":"Agents Json Manifest","description":"Standardized x402 & M2M agent catalog (includes auto-deployed Scout endpoints).","operationId":"agents_json_manifest_agents_json_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Agents Json Manifest Agents Json Head"}}}}}},"head":{"tags":["AI Discovery & Autonomous Scout"],"summary":"Agents Json Manifest","description":"Standardized x402 & M2M agent catalog (includes auto-deployed Scout endpoints).","operationId":"agents_json_manifest_agents_json_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Agents Json Manifest Agents Json Head"}}}}}}},"/.well-known/agent.json":{"get":{"tags":["AI Discovery & Autonomous Scout"],"summary":"Well Known Agent Card","description":"A2A-compatible Agent Card for autonomous multi-agent ecosystems.","operationId":"well_known_agent_card__well_known_agent_json_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"head":{"tags":["AI Discovery & Autonomous Scout"],"summary":"Well Known Agent Card","description":"A2A-compatible Agent Card for autonomous multi-agent ecosystems.","operationId":"well_known_agent_card__well_known_agent_json_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/catalog":{"get":{"tags":["AI Discovery & Autonomous Scout"],"summary":"Api Catalog Endpoint","description":"Full machine-readable API catalog for x402 v2 catalog bots and AI agents.","operationId":"api_catalog_endpoint_catalog_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"head":{"tags":["AI Discovery & Autonomous Scout"],"summary":"Api Catalog Endpoint","description":"Full machine-readable API catalog for x402 v2 catalog bots and AI agents.","operationId":"api_catalog_endpoint_catalog_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/catalog":{"get":{"tags":["AI Discovery & Autonomous Scout"],"summary":"Api Catalog Endpoint","description":"Full machine-readable API catalog for x402 v2 catalog bots and AI agents.","operationId":"api_catalog_endpoint_api_catalog_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"head":{"tags":["AI Discovery & Autonomous Scout"],"summary":"Api Catalog Endpoint","description":"Full machine-readable API catalog for x402 v2 catalog bots and AI agents.","operationId":"api_catalog_endpoint_api_catalog_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/x402":{"get":{"tags":["AI Discovery & Autonomous Scout"],"summary":"Well Known X402 Manifest","description":"Official x402 v2 discovery card for autonomous buying agents and crawlers.","operationId":"well_known_x402_manifest__well_known_x402_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"head":{"tags":["AI Discovery & Autonomous Scout"],"summary":"Well Known X402 Manifest","description":"Official x402 v2 discovery card for autonomous buying agents and crawlers.","operationId":"well_known_x402_manifest__well_known_x402_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/x402.json":{"get":{"tags":["AI Discovery & Autonomous Scout"],"summary":"Well Known X402 Manifest","description":"Official x402 v2 discovery card for autonomous buying agents and crawlers.","operationId":"well_known_x402_manifest__well_known_x402_json_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"head":{"tags":["AI Discovery & Autonomous Scout"],"summary":"Well Known X402 Manifest","description":"Official x402 v2 discovery card for autonomous buying agents and crawlers.","operationId":"well_known_x402_manifest__well_known_x402_json_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/glama.json":{"get":{"tags":["AI Discovery & Autonomous Scout"],"summary":"Well Known Glama Manifest","description":"Glama.ai MCP Directory ownership & claim verification manifest.","operationId":"well_known_glama_manifest__well_known_glama_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Well Known Glama Manifest  Well Known Glama Json Get"}}}}}}},"/mcp/.well-known/glama.json":{"get":{"tags":["AI Discovery & Autonomous Scout"],"summary":"Well Known Glama Manifest","description":"Glama.ai MCP Directory ownership & claim verification manifest.","operationId":"well_known_glama_manifest_mcp__well_known_glama_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Well Known Glama Manifest Mcp  Well Known Glama Json Get"}}}}}}},"/cron/discover":{"get":{"tags":["AI Discovery & Autonomous Scout"],"summary":"Trigger Autonomous Scout","description":"Run the Autonomous Scout to discover AND auto-deploy a new M2M API endpoint.\nRequires X-Admin-Pin or X-Scout-Token in production (bypassed only in TESTING mode if no header sent).","operationId":"trigger_autonomous_scout_cron_discover_get","parameters":[{"name":"X-Admin-Pin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Pin"}},{"name":"X-Scout-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Scout-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Trigger Autonomous Scout Cron Discover Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["AI Discovery & Autonomous Scout"],"summary":"Trigger Autonomous Scout","description":"Run the Autonomous Scout to discover AND auto-deploy a new M2M API endpoint.\nRequires X-Admin-Pin or X-Scout-Token in production (bypassed only in TESTING mode if no header sent).","operationId":"trigger_autonomous_scout_cron_discover_get","parameters":[{"name":"X-Admin-Pin","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Admin-Pin"}},{"name":"X-Scout-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Scout-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Trigger Autonomous Scout Cron Discover Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/mcp":{"get":{"tags":["AI Discovery & Autonomous Scout"],"summary":"Mcp Server Endpoint","description":"Model Context Protocol (MCP) Streamable HTTP / JSON-RPC 2.0 Server Endpoint.\nSupports MCP JSON-RPC methods (`initialize`, `notifications/initialized`, `ping`,\n`tools/list`, `tools/call`, `resources/list`, `prompts/list`) for Glama, Smithery & Claude Desktop,\nas well as human/crawler GET discovery.","operationId":"mcp_server_endpoint_mcp_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["AI Discovery & Autonomous Scout"],"summary":"Mcp Server Endpoint","description":"Model Context Protocol (MCP) Streamable HTTP / JSON-RPC 2.0 Server Endpoint.\nSupports MCP JSON-RPC methods (`initialize`, `notifications/initialized`, `ping`,\n`tools/list`, `tools/call`, `resources/list`, `prompts/list`) for Glama, Smithery & Claude Desktop,\nas well as human/crawler GET discovery.","operationId":"mcp_server_endpoint_mcp_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/terms":{"get":{"tags":["AI Discovery & Autonomous Scout"],"summary":"Terms Of Service","description":"Terms of Service for AIM Network Autonomous M2M Services (HTML & JSON).","operationId":"terms_of_service_terms_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"head":{"tags":["AI Discovery & Autonomous Scout"],"summary":"Terms Of Service","description":"Terms of Service for AIM Network Autonomous M2M Services (HTML & JSON).","operationId":"terms_of_service_terms_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/privacy":{"get":{"tags":["AI Discovery & Autonomous Scout"],"summary":"Privacy Policy","description":"Privacy Policy & GDPR Compliance Disclosure for M2M Agents and Humans.","operationId":"privacy_policy_privacy_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"head":{"tags":["AI Discovery & Autonomous Scout"],"summary":"Privacy Policy","description":"Privacy Policy & GDPR Compliance Disclosure for M2M Agents and Humans.","operationId":"privacy_policy_privacy_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/refund":{"get":{"tags":["AI Discovery & Autonomous Scout"],"summary":"Refund Policy","description":"Transparent Settlement & Refund Policy for x402 Micropayments.","operationId":"refund_policy_refund_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"head":{"tags":["AI Discovery & Autonomous Scout"],"summary":"Refund Policy","description":"Transparent Settlement & Refund Policy for x402 Micropayments.","operationId":"refund_policy_refund_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/status":{"get":{"tags":["AI Discovery & Autonomous Scout"],"summary":"Service Status","description":"System health, upstream SLA metrics, and operational status (HTML & JSON).","operationId":"service_status_status_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"head":{"tags":["AI Discovery & Autonomous Scout"],"summary":"Service Status","description":"System health, upstream SLA metrics, and operational status (HTML & JSON).","operationId":"service_status_status_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/free-teaser":{"get":{"tags":["M2M Paid Data Endpoints"],"summary":"Get Free Teaser","description":"Free Zero-Auth Verification Teaser ($0.00 USDC):\nAllows autonomous buying bots to verify <150ms latency and live data freshness before paying via x402.","operationId":"get_free_teaser_api_v1_free_teaser_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"x-payment-protocol":"free","x-price-usdc":0.0},"head":{"tags":["M2M Paid Data Endpoints"],"summary":"Get Free Teaser","description":"Free Zero-Auth Verification Teaser ($0.00 USDC):\nAllows autonomous buying bots to verify <150ms latency and live data freshness before paying via x402.","operationId":"get_free_teaser_api_v1_free_teaser_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"x-payment-protocol":"free","x-price-usdc":0.0}},"/api/v1/trending":{"get":{"tags":["M2M Paid Data Endpoints"],"summary":"List Trending Tokens","description":"Free Public Discovery Index ($0.00 USDC):\nLists all currently active momentum and trending tokens tracked by the Autonomous Scout agent.","operationId":"list_trending_tokens_api_v1_trending_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"x-payment-protocol":"free","x-price-usdc":0.0},"head":{"tags":["M2M Paid Data Endpoints"],"summary":"List Trending Tokens","description":"Free Public Discovery Index ($0.00 USDC):\nLists all currently active momentum and trending tokens tracked by the Autonomous Scout agent.","operationId":"list_trending_tokens_api_v1_trending_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"x-payment-protocol":"free","x-price-usdc":0.0}},"/api/v1/vip-pass":{"head":{"tags":["M2M Paid Data Endpoints"],"summary":"Vip Pass Status Or Quote","description":"Inspect 24h VIP Pass status and remaining calls.\nProvide pass tx_hash via query parameter (?tx_hash=0x...) or X-PAYMENT-PROOF header.\nWithout a valid pass, returns x402 machine-readable pricing and purchase instructions.","operationId":"vip_pass_status_or_quote_api_v1_vip_pass_head","parameters":[{"name":"tx_hash","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tx Hash"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-protocol":"x402-vip","x-price-usdc":1.5},"get":{"tags":["M2M Paid Data Endpoints"],"summary":"Vip Pass Status Or Quote","description":"Inspect 24h VIP Pass status and remaining calls.\nProvide pass tx_hash via query parameter (?tx_hash=0x...) or X-PAYMENT-PROOF header.\nWithout a valid pass, returns x402 machine-readable pricing and purchase instructions.","operationId":"vip_pass_status_or_quote_api_v1_vip_pass_head","parameters":[{"name":"tx_hash","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tx Hash"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-protocol":"x402-vip","x-price-usdc":1.5}},"/api/v1/base-dex-radar":{"get":{"tags":["M2M Paid Data Endpoints"],"summary":"Get Base Dex Radar","description":"Base L2 DEX Liquidity & Whale Inflow Radar ($0.05 USDC):\nDelivers real-time top Base DEX pools, volume spikes, and whale inflow signals via DexScreener.\nAppend ?sample=true for a free schema verification sample.","operationId":"get_base_dex_radar_api_v1_base_dex_radar_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"x-payment-protocol":"x402","x-payment-network":"base-mainnet","x-payment-chain-id":8453,"x-payment-token":"USDC","x-payment-token-contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","x-payment-recipient":"0x1bbae07abebbb61f611391e02e81ee26b0c47b79","x-payment-price-usdc":0.02,"x-sample-url":"/api/v1/base-dex-radar?sample=true"},"head":{"tags":["M2M Paid Data Endpoints"],"summary":"Get Base Dex Radar","description":"Base L2 DEX Liquidity & Whale Inflow Radar ($0.05 USDC):\nDelivers real-time top Base DEX pools, volume spikes, and whale inflow signals via DexScreener.\nAppend ?sample=true for a free schema verification sample.","operationId":"get_base_dex_radar_api_v1_base_dex_radar_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"x-payment-protocol":"x402","x-payment-network":"base-mainnet","x-payment-chain-id":8453,"x-payment-token":"USDC","x-payment-token-contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","x-payment-recipient":"0x1bbae07abebbb61f611391e02e81ee26b0c47b79","x-payment-price-usdc":0.02,"x-sample-url":"/api/v1/base-dex-radar?sample=true"}},"/api/v1/crypto-pulse":{"get":{"tags":["M2M Paid Data Endpoints"],"summary":"Get Crypto Pulse","description":"Tier 1 Micro-API ($0.01 USDC):\nDelivers real-time crypto prices, 24h volatility index, and Fear & Greed sentiment.\nAppend ?sample=true for a free schema verification sample.","operationId":"get_crypto_pulse_api_v1_crypto_pulse_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"x-payment-protocol":"x402","x-payment-network":"base-mainnet","x-payment-chain-id":8453,"x-payment-token":"USDC","x-payment-token-contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","x-payment-recipient":"0x1bbae07abebbb61f611391e02e81ee26b0c47b79","x-payment-price-usdc":0.005,"x-sample-url":"/api/v1/crypto-pulse?sample=true"},"head":{"tags":["M2M Paid Data Endpoints"],"summary":"Get Crypto Pulse","description":"Tier 1 Micro-API ($0.01 USDC):\nDelivers real-time crypto prices, 24h volatility index, and Fear & Greed sentiment.\nAppend ?sample=true for a free schema verification sample.","operationId":"get_crypto_pulse_api_v1_crypto_pulse_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"x-payment-protocol":"x402","x-payment-network":"base-mainnet","x-payment-chain-id":8453,"x-payment-token":"USDC","x-payment-token-contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","x-payment-recipient":"0x1bbae07abebbb61f611391e02e81ee26b0c47b79","x-payment-price-usdc":0.005,"x-sample-url":"/api/v1/crypto-pulse?sample=true"}},"/api/v1/deep-market-report":{"get":{"tags":["M2M Paid Data Endpoints"],"summary":"Get Deep Market Report","description":"Tier 2 Premium-API ($1.00 USDC):\nDelivers deep quantitative M2M market analysis, Base L2 liquidity metrics, and actionable signals.\nAppend ?sample=true for a free schema verification sample.","operationId":"get_deep_market_report_api_v1_deep_market_report_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"x-payment-protocol":"x402","x-payment-network":"base-mainnet","x-payment-chain-id":8453,"x-payment-token":"USDC","x-payment-token-contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","x-payment-recipient":"0x1bbae07abebbb61f611391e02e81ee26b0c47b79","x-payment-price-usdc":0.15,"x-sample-url":"/api/v1/deep-market-report?sample=true"},"head":{"tags":["M2M Paid Data Endpoints"],"summary":"Get Deep Market Report","description":"Tier 2 Premium-API ($1.00 USDC):\nDelivers deep quantitative M2M market analysis, Base L2 liquidity metrics, and actionable signals.\nAppend ?sample=true for a free schema verification sample.","operationId":"get_deep_market_report_api_v1_deep_market_report_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"x-payment-protocol":"x402","x-payment-network":"base-mainnet","x-payment-chain-id":8453,"x-payment-token":"USDC","x-payment-token-contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","x-payment-recipient":"0x1bbae07abebbb61f611391e02e81ee26b0c47b79","x-payment-price-usdc":0.15,"x-sample-url":"/api/v1/deep-market-report?sample=true"}},"/api/v1/trending/{slug}":{"head":{"tags":["M2M Paid Data Endpoints"],"summary":"Get Dynamic Trending Endpoint","description":"Auto-Deployed Scout Endpoint ($0.05 USDC):\nDelivers real-time orderflow, price, and momentum for trending assets discovered by the Autonomous Scout.\nAppend ?sample=true for a free schema verification sample.","operationId":"get_dynamic_trending_endpoint_api_v1_trending__slug__head","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-protocol":"x402","x-payment-network":"base-mainnet","x-payment-chain-id":8453,"x-payment-token":"USDC","x-payment-token-contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","x-payment-recipient":"0x1bbae07abebbb61f611391e02e81ee26b0c47b79","x-payment-price-usdc":0.01,"x-sample-url":"/api/v1/trending/{slug}?sample=true"},"get":{"tags":["M2M Paid Data Endpoints"],"summary":"Get Dynamic Trending Endpoint","description":"Auto-Deployed Scout Endpoint ($0.05 USDC):\nDelivers real-time orderflow, price, and momentum for trending assets discovered by the Autonomous Scout.\nAppend ?sample=true for a free schema verification sample.","operationId":"get_dynamic_trending_endpoint_api_v1_trending__slug__head","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-protocol":"x402","x-payment-network":"base-mainnet","x-payment-chain-id":8453,"x-payment-token":"USDC","x-payment-token-contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","x-payment-recipient":"0x1bbae07abebbb61f611391e02e81ee26b0c47b79","x-payment-price-usdc":0.01,"x-sample-url":"/api/v1/trending/{slug}?sample=true"}},"/api/v1/arb-scanner":{"get":{"tags":["M2M Paid Data Endpoints"],"summary":"Get Arb Scanner","description":"Base L2 Real-time Arbitrage, Spread & Momentum Scanner ($0.005 USDC):\nDelivers cross-asset ratios (ETH/BTC, SOL/ETH), spread efficiency, and Base L2 gas benchmarks.\nAppend ?sample=true for a free schema verification sample.","operationId":"get_arb_scanner_api_v1_arb_scanner_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"x-payment-protocol":"x402","x-payment-network":"base-mainnet","x-payment-chain-id":8453,"x-payment-token":"USDC","x-payment-token-contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","x-payment-recipient":"0x1bbae07abebbb61f611391e02e81ee26b0c47b79","x-payment-price-usdc":0.005,"x-sample-url":"/api/v1/arb-scanner?sample=true"},"head":{"tags":["M2M Paid Data Endpoints"],"summary":"Get Arb Scanner","description":"Base L2 Real-time Arbitrage, Spread & Momentum Scanner ($0.005 USDC):\nDelivers cross-asset ratios (ETH/BTC, SOL/ETH), spread efficiency, and Base L2 gas benchmarks.\nAppend ?sample=true for a free schema verification sample.","operationId":"get_arb_scanner_api_v1_arb_scanner_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"x-payment-protocol":"x402","x-payment-network":"base-mainnet","x-payment-chain-id":8453,"x-payment-token":"USDC","x-payment-token-contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","x-payment-recipient":"0x1bbae07abebbb61f611391e02e81ee26b0c47b79","x-payment-price-usdc":0.005,"x-sample-url":"/api/v1/arb-scanner?sample=true"}},"/api/v1/sentiment-signals":{"get":{"tags":["M2M Paid Data Endpoints"],"summary":"Get Sentiment Signals","description":"Multi-Source Quantitative Sentiment & Action Signals ($0.020 USDC):\nDelivers structured quantitative trading signals (regime, primary signal, confidence score, and key drivers).\nAppend ?sample=true for a free schema verification sample.","operationId":"get_sentiment_signals_api_v1_sentiment_signals_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"x-payment-protocol":"x402","x-payment-network":"base-mainnet","x-payment-chain-id":8453,"x-payment-token":"USDC","x-payment-token-contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","x-payment-recipient":"0x1bbae07abebbb61f611391e02e81ee26b0c47b79","x-payment-price-usdc":0.02,"x-sample-url":"/api/v1/sentiment-signals?sample=true"},"head":{"tags":["M2M Paid Data Endpoints"],"summary":"Get Sentiment Signals","description":"Multi-Source Quantitative Sentiment & Action Signals ($0.020 USDC):\nDelivers structured quantitative trading signals (regime, primary signal, confidence score, and key drivers).\nAppend ?sample=true for a free schema verification sample.","operationId":"get_sentiment_signals_api_v1_sentiment_signals_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"x-payment-protocol":"x402","x-payment-network":"base-mainnet","x-payment-chain-id":8453,"x-payment-token":"USDC","x-payment-token-contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","x-payment-recipient":"0x1bbae07abebbb61f611391e02e81ee26b0c47b79","x-payment-price-usdc":0.02,"x-sample-url":"/api/v1/sentiment-signals?sample=true"}},"/api/v1/multi-source-dossier":{"get":{"tags":["M2M Paid Data Endpoints"],"summary":"Get Multi Source Dossier","description":"Comprehensive Multi-Source Intelligence Dossier ($0.150 USDC):\nDelivers multi-source spot data, Base liquidity metrics, sentiment, and actionable trading directives.\nAppend ?sample=true for a free schema verification sample.","operationId":"get_multi_source_dossier_api_v1_multi_source_dossier_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"x-payment-protocol":"x402","x-payment-network":"base-mainnet","x-payment-chain-id":8453,"x-payment-token":"USDC","x-payment-token-contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","x-payment-recipient":"0x1bbae07abebbb61f611391e02e81ee26b0c47b79","x-payment-price-usdc":0.15,"x-sample-url":"/api/v1/multi-source-dossier?sample=true"},"head":{"tags":["M2M Paid Data Endpoints"],"summary":"Get Multi Source Dossier","description":"Comprehensive Multi-Source Intelligence Dossier ($0.150 USDC):\nDelivers multi-source spot data, Base liquidity metrics, sentiment, and actionable trading directives.\nAppend ?sample=true for a free schema verification sample.","operationId":"get_multi_source_dossier_api_v1_multi_source_dossier_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"x-payment-protocol":"x402","x-payment-network":"base-mainnet","x-payment-chain-id":8453,"x-payment-token":"USDC","x-payment-token-contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","x-payment-recipient":"0x1bbae07abebbb61f611391e02e81ee26b0c47b79","x-payment-price-usdc":0.15,"x-sample-url":"/api/v1/multi-source-dossier?sample=true"}},"/api/v1/quality/{slug}":{"head":{"tags":["M2M Paid Data Endpoints"],"summary":"Get Data Quality Audit","description":"Data Quality, Staleness & Integrity Audit per Asset ($0.002 USDC):\nDelivers verifiable data age, upstream status, fallback flags, and consensus health.\nAppend ?sample=true for a free schema verification sample.","operationId":"get_data_quality_audit_api_v1_quality__slug__head","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-protocol":"x402","x-payment-network":"base-mainnet","x-payment-chain-id":8453,"x-payment-token":"USDC","x-payment-token-contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","x-payment-recipient":"0x1bbae07abebbb61f611391e02e81ee26b0c47b79","x-payment-price-usdc":0.002,"x-sample-url":"/api/v1/quality/btc?sample=true"},"get":{"tags":["M2M Paid Data Endpoints"],"summary":"Get Data Quality Audit","description":"Data Quality, Staleness & Integrity Audit per Asset ($0.002 USDC):\nDelivers verifiable data age, upstream status, fallback flags, and consensus health.\nAppend ?sample=true for a free schema verification sample.","operationId":"get_data_quality_audit_api_v1_quality__slug__head","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-protocol":"x402","x-payment-network":"base-mainnet","x-payment-chain-id":8453,"x-payment-token":"USDC","x-payment-token-contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","x-payment-recipient":"0x1bbae07abebbb61f611391e02e81ee26b0c47b79","x-payment-price-usdc":0.002,"x-sample-url":"/api/v1/quality/btc?sample=true"}},"/health":{"get":{"tags":["System"],"summary":"Health Check","operationId":"health_check_health_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"head":{"tags":["System"],"summary":"Health Check","operationId":"health_check_health_head","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"LoginRequest":{"properties":{"pin":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pin"}},"type":"object","title":"LoginRequest"},"ModeToggleRequest":{"properties":{"pin":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pin"},"mode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mode"}},"type":"object","title":"ModeToggleRequest"},"PauseToggleRequest":{"properties":{"pin":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pin"},"paused":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Paused"}},"type":"object","title":"PauseToggleRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}