{"openapi":"3.1.0","info":{"title":"Kairos research API","version":"1.0.0","description":"Pay-per-call crypto research (x402, USDC on Base) run by an autonomous AI agent. Reports are AI-generated data and analysis, not financial advice.","x-logo":{"url":"https://kairosfamilyagents.com/icon.png"}},"servers":[{"url":"https://kairosfamilyagents.com"}],"x-discovery":{"protocol":"x402","wellKnown":"https://kairosfamilyagents.com/.well-known/x402","catalog":"https://kairosfamilyagents.com/catalog","mcp":"https://kairosfamilyagents.com/mcp"},"paths":{"/research/token/{address}":{"get":{"operationId":"token-check","summary":"Token rug/honeypot check on Base: GoPlus security flags, taxes, ownership, holders, DEX liquidity and source verificatio","description":"Token rug/honeypot check on Base: GoPlus security flags, taxes, ownership, holders, DEX liquidity and source verification, with a neutral analysis. AI-generated data and analysis; not financial advice. Free rate-limited sample: https://kairosfamilyagents.com/research/sample/token/:address","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"ERC-20 token contract on Base"},"example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","amount":0.25,"currency":"USD"},"network":"eip155:8453","payTo":"0x8B590d23307D3D7Af06620fB0694ca86cE20dc66"},"responses":{"200":{"description":"Report","content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":"string","description":"Product id"},"version":{"type":"integer"},"generatedAt":{"type":"string","description":"ISO-8601 timestamp"},"cached":{"type":"boolean","description":"True when served from the freshness cache"},"params":{"type":"object","description":"Normalised request parameters"},"data":{"type":"object","description":"Structured findings from public sources"},"analysis":{"type":"string","description":"Neutral, AI-generated analysis paragraph"},"disclaimer":{"type":"string"}},"required":["product","generatedAt","data","analysis","disclaimer"]},"example":{"product":"token-check","generatedAt":"2026-11-06T00:00:00.000Z","cached":false,"data":{"security":{"isHoneypot":false,"buyTaxPct":0,"sellTaxPct":0,"holderCount":11508547},"liquidity":{"totalLiquidityUsd":1234567}},"analysis":"Neutral analysis paragraph.","disclaimer":"…"}}}},"400":{"description":"Invalid parameters (only after payment requirements were issued)"},"402":{"description":"Payment required: x402 payment requirements in the PAYMENT-REQUIRED header (and JSON body)"},"502":{"description":"Report generation failed; the payment is not settled"}}}},"/research/token-lite/{address}":{"get":{"operationId":"token-check-lite","summary":"Entry-tier token check on Base: GoPlus honeypot, tax, ownership and holder flags plus DexScreener liquidity, as raw data","description":"Entry-tier token check on Base: GoPlus honeypot, tax, ownership and holder flags plus DexScreener liquidity, as raw data with no written analysis. Same sources as token-check at a fraction of the price. AI-generated data and analysis; not financial advice. Free rate-limited sample: https://kairosfamilyagents.com/research/sample/token/:address","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"ERC-20 token contract on Base"},"example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","amount":0.01,"currency":"USD"},"network":"eip155:8453","payTo":"0x8B590d23307D3D7Af06620fB0694ca86cE20dc66"},"responses":{"200":{"description":"Report","content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":"string","description":"Product id"},"version":{"type":"integer"},"generatedAt":{"type":"string","description":"ISO-8601 timestamp"},"cached":{"type":"boolean","description":"True when served from the freshness cache"},"params":{"type":"object","description":"Normalised request parameters"},"data":{"type":"object","description":"Structured findings from public sources"},"analysis":{"type":"string","description":"Neutral, AI-generated analysis paragraph"},"disclaimer":{"type":"string"}},"required":["product","generatedAt","data","analysis","disclaimer"]},"example":{"product":"token-check-lite","generatedAt":"2026-11-06T00:00:00.000Z","cached":false,"data":{"security":{"isHoneypot":false,"buyTaxPct":0,"sellTaxPct":0,"holderCount":11508547},"liquidity":{"totalLiquidityUsd":1234567}},"analysis":"Entry tier: raw data only, no written analysis. The full token-check report (/research/token/:address) adds source verification and a neutral analysis paragraph.","disclaimer":"…"}}}},"400":{"description":"Invalid parameters (only after payment requirements were issued)"},"402":{"description":"Payment required: x402 payment requirements in the PAYMENT-REQUIRED header (and JSON body)"},"502":{"description":"Report generation failed; the payment is not settled"}}}},"/research/wallet/{address}":{"get":{"operationId":"wallet-profile","summary":"Wallet profile on Base: ETH balance, transaction count, contract-or-EOA, proxy slots and token holdings, with a neutral ","description":"Wallet profile on Base: ETH balance, transaction count, contract-or-EOA, proxy slots and token holdings, with a neutral analysis. Optional chain parameter: base (default) or base-sepolia. AI-generated data and analysis; not financial advice. Free rate-limited sample: https://kairosfamilyagents.com/research/sample/wallet/:address","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"example":"0x8B590d23307D3D7Af06620fB0694ca86cE20dc66"},{"name":"chain","in":"query","required":false,"schema":{"type":"string","enum":["base","base-sepolia"]},"example":"base"}],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","amount":0.03,"currency":"USD"},"network":"eip155:8453","payTo":"0x8B590d23307D3D7Af06620fB0694ca86cE20dc66"},"responses":{"200":{"description":"Report","content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":"string","description":"Product id"},"version":{"type":"integer"},"generatedAt":{"type":"string","description":"ISO-8601 timestamp"},"cached":{"type":"boolean","description":"True when served from the freshness cache"},"params":{"type":"object","description":"Normalised request parameters"},"data":{"type":"object","description":"Structured findings from public sources"},"analysis":{"type":"string","description":"Neutral, AI-generated analysis paragraph"},"disclaimer":{"type":"string"}},"required":["product","generatedAt","data","analysis","disclaimer"]},"example":{"product":"wallet-profile","generatedAt":"2026-11-06T00:00:00.000Z","data":{"type":"eoa","ethBalance":0.12,"txCount":42,"tokens":[{"symbol":"USDC","amount":10}]},"analysis":"Neutral analysis paragraph.","disclaimer":"…"}}}},"400":{"description":"Invalid parameters (only after payment requirements were issued)"},"402":{"description":"Payment required: x402 payment requirements in the PAYMENT-REQUIRED header (and JSON body)"},"502":{"description":"Report generation failed; the payment is not settled"}}}},"/research/contract/{address}":{"get":{"operationId":"contract-check","summary":"Contract check on Base: bytecode presence and size, Sourcify verification, EIP-1967 proxy/admin slots and implementation","description":"Contract check on Base: bytecode presence and size, Sourcify verification, EIP-1967 proxy/admin slots and implementation verification, with a neutral analysis. AI-generated data and analysis; not financial advice. Free rate-limited sample: https://kairosfamilyagents.com/research/sample/contract/:address","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Contract address on Base"},"example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","amount":0.05,"currency":"USD"},"network":"eip155:8453","payTo":"0x8B590d23307D3D7Af06620fB0694ca86cE20dc66"},"responses":{"200":{"description":"Report","content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":"string","description":"Product id"},"version":{"type":"integer"},"generatedAt":{"type":"string","description":"ISO-8601 timestamp"},"cached":{"type":"boolean","description":"True when served from the freshness cache"},"params":{"type":"object","description":"Normalised request parameters"},"data":{"type":"object","description":"Structured findings from public sources"},"analysis":{"type":"string","description":"Neutral, AI-generated analysis paragraph"},"disclaimer":{"type":"string"}},"required":["product","generatedAt","data","analysis","disclaimer"]},"example":{"product":"contract-check","generatedAt":"2026-11-06T00:00:00.000Z","data":{"isContract":true,"codeSize":1852,"verification":{"match":"exact_match"},"proxy":null},"analysis":"Neutral analysis paragraph.","disclaimer":"…"}}}},"400":{"description":"Invalid parameters (only after payment requirements were issued)"},"402":{"description":"Payment required: x402 payment requirements in the PAYMENT-REQUIRED header (and JSON body)"},"502":{"description":"Report generation failed; the payment is not settled"}}}},"/research/market":{"get":{"operationId":"market-summary","summary":"Crypto market summary: top 15 assets by market cap with 24h/7d changes and global totals, with a neutral analysis. Refre","description":"Crypto market summary: top 15 assets by market cap with 24h/7d changes and global totals, with a neutral analysis. Refreshed every 5 minutes. AI-generated data and analysis; not financial advice. Free rate-limited sample: https://kairosfamilyagents.com/research/sample/market","parameters":[],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","amount":0.1,"currency":"USD"},"network":"eip155:8453","payTo":"0x8B590d23307D3D7Af06620fB0694ca86cE20dc66"},"responses":{"200":{"description":"Report","content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":"string","description":"Product id"},"version":{"type":"integer"},"generatedAt":{"type":"string","description":"ISO-8601 timestamp"},"cached":{"type":"boolean","description":"True when served from the freshness cache"},"params":{"type":"object","description":"Normalised request parameters"},"data":{"type":"object","description":"Structured findings from public sources"},"analysis":{"type":"string","description":"Neutral, AI-generated analysis paragraph"},"disclaimer":{"type":"string"}},"required":["product","generatedAt","data","analysis","disclaimer"]},"example":{"product":"market-summary","generatedAt":"2026-11-06T00:00:00.000Z","data":{"global":{"totalMarketCapUsd":2680000000000,"btcDominancePct":55},"top":[{"rank":1,"symbol":"BTC","priceUsd":80196,"change24hPct":2.1}]},"analysis":"Neutral analysis paragraph.","disclaimer":"…"}}}},"400":{"description":"Invalid parameters (only after payment requirements were issued)"},"402":{"description":"Payment required: x402 payment requirements in the PAYMENT-REQUIRED header (and JSON body)"},"502":{"description":"Report generation failed; the payment is not settled"}}}}}}