{"openapi":"3.1.0","info":{"title":"Token Lens Agent API","version":"1.2.0","description":"可扩展Agent接口平台。已上线token-risk、etf-flows和fear-greed；其他Agent仅在目录中列为planned。公共预览无API Key、无SLA；15次/分钟/IP，免费上游可限流。金额/百分比通常使用十进制字符串，时间戳为Unix秒，ETF交易日为YYYY-MM-DD；null表示未知。"},"servers":[{"url":"https://agent.vestpivot.com","description":"Cloudflare公共预览"}],"tags":[{"name":"Platform"},{"name":"Token Risk"},{"name":"ETF Flows"},{"name":"Fear and Greed"}],"security":[],"paths":{"/api/v1/health":{"get":{"operationId":"getApiHealth","tags":["Platform"],"summary":"API进程健康检查，不探测上游供应商","responses":{"200":{"description":"服务正常","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}}}}},"/api/v1/agents":{"get":{"operationId":"listAgents","tags":["Platform"],"summary":"列出已上线与规划中的Agent，调用前检查callable","responses":{"200":{"description":"data.items是Agent目录；planned项不可调用","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Envelope"},{"type":"object","properties":{"data":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/AgentDescriptor"}}},"required":["items"]}},"required":["data"]}]}}}}}}},"/api/v1/agents/{agent_id}":{"get":{"operationId":"getAgent","tags":["Platform"],"summary":"查看一个Agent的功能、版本、状态和限制","parameters":[{"in":"path","name":"agent_id","required":true,"schema":{"type":"string"},"example":"token-risk"}],"responses":{"200":{"description":"Agent目录详情","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Envelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/AgentDescriptor"}},"required":["data"]}]}}}},"404":{"description":"Agent或接口不存在","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}}}}},"/api/v1/openapi.json":{"get":{"operationId":"getOpenApi","tags":["Platform"],"summary":"下载OpenAPI规范；此端点直接返回OpenAPI文档，不包Envelope","responses":{"200":{"description":"OpenAPI 3.1文档","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/agents/token-risk/analyze":{"post":{"operationId":"tokenRiskAnalyze","tags":["Token Risk"],"summary":"代币综合风险分析","description":"返回五个风险维度、权限线索、来源和完整度。采集范围受免费供应商限制。 子接口共享完整采集和60秒缓存，仅缩小返回范围；服务器数据与网页浏览器回退结果可能不同。","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenInput"},"example":{"chain":"ethereum","token_address":"0xdac17f958d2ee523a2206206994597c13d831ec7"}}}},"responses":{"200":{"description":"请求成功；status可能为partial，请检查warnings及meta.coverage","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Envelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Report"}},"required":["data"]}]}}}},"400":{"description":"参数或JSON错误","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"Agent或接口不存在","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"405":{"description":"方法不支持","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"413":{"description":"请求体过大","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"415":{"description":"Content-Type错误","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"429":{"description":"频率超限","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"本版本为60秒"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"500":{"description":"内部错误","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"501":{"description":"Agent仍在规划中","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"502":{"description":"分析服务错误","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"503":{"description":"所请求模块全部数据不足，data仍保留覆盖说明","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}}}}},"/api/v1/agents/token-risk/holders":{"post":{"operationId":"tokenRiskHolders","tags":["Token Risk"],"summary":"前20持有人","description":"按供应商余额排名返回最多20个持有人、持仓占比与精确原始余额。 子接口共享完整采集和60秒缓存，仅缩小返回范围；服务器数据与网页浏览器回退结果可能不同。","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenInput"},"example":{"chain":"ethereum","token_address":"0xdac17f958d2ee523a2206206994597c13d831ec7"}}}},"responses":{"200":{"description":"请求成功；status可能为partial，请检查warnings及meta.coverage","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Envelope"},{"type":"object","properties":{"data":{"type":"object","properties":{"token":{"$ref":"#/components/schemas/Token"},"module":{"const":"holders_top20"},"result":{"$ref":"#/components/schemas/HoldersModule"},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}}},"required":["token","module","result","sources"]}},"required":["data"]}]}}}},"400":{"description":"参数或JSON错误","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"Agent或接口不存在","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"405":{"description":"方法不支持","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"413":{"description":"请求体过大","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"415":{"description":"Content-Type错误","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"429":{"description":"频率超限","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"本版本为60秒"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"500":{"description":"内部错误","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"501":{"description":"Agent仍在规划中","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"502":{"description":"分析服务错误","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"503":{"description":"所请求模块全部数据不足，data仍保留覆盖说明","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}}}}},"/api/v1/agents/token-risk/liquidity":{"post":{"operationId":"tokenRiskLiquidity","tags":["Token Risk"],"summary":"流动性与历史变化","description":"返回去重后的池子、当前美元流动性和已积累快照的1h/6h/24h变化。 子接口共享完整采集和60秒缓存，仅缩小返回范围；服务器数据与网页浏览器回退结果可能不同。","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenInput"},"example":{"chain":"ethereum","token_address":"0xdac17f958d2ee523a2206206994597c13d831ec7"}}}},"responses":{"200":{"description":"请求成功；status可能为partial，请检查warnings及meta.coverage","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Envelope"},{"type":"object","properties":{"data":{"type":"object","properties":{"token":{"$ref":"#/components/schemas/Token"},"module":{"const":"liquidity"},"result":{"$ref":"#/components/schemas/LiquidityModule"},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}}},"required":["token","module","result","sources"]}},"required":["data"]}]}}}},"400":{"description":"参数或JSON错误","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"Agent或接口不存在","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"405":{"description":"方法不支持","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"413":{"description":"请求体过大","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"415":{"description":"Content-Type错误","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"429":{"description":"频率超限","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"本版本为60秒"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"500":{"description":"内部错误","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"501":{"description":"Agent仍在规划中","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"502":{"description":"分析服务错误","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"503":{"description":"所请求模块全部数据不足，data仍保留覆盖说明","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}}}}},"/api/v1/agents/token-risk/large-transactions":{"post":{"operationId":"tokenRiskLargeTransactions","tags":["Token Risk"],"summary":"大额成交与转账","description":"返回10万美元以上的大额DEX成交、近期转账样本和覆盖窗口；不能视为全链完整24小时。 子接口共享完整采集和60秒缓存，仅缩小返回范围；服务器数据与网页浏览器回退结果可能不同。","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenInput"},"example":{"chain":"ethereum","token_address":"0xdac17f958d2ee523a2206206994597c13d831ec7"}}}},"responses":{"200":{"description":"请求成功；status可能为partial，请检查warnings及meta.coverage","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Envelope"},{"type":"object","properties":{"data":{"type":"object","properties":{"token":{"$ref":"#/components/schemas/Token"},"module":{"const":"large_transactions_24h"},"result":{"$ref":"#/components/schemas/LargeTransactionsModule"},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}}},"required":["token","module","result","sources"]}},"required":["data"]}]}}}},"400":{"description":"参数或JSON错误","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"Agent或接口不存在","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"405":{"description":"方法不支持","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"413":{"description":"请求体过大","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"415":{"description":"Content-Type错误","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"429":{"description":"频率超限","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"本版本为60秒"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"500":{"description":"内部错误","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"501":{"description":"Agent仍在规划中","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"502":{"description":"分析服务错误","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"503":{"description":"所请求模块全部数据不足，data仍保留覆盖说明","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}}}}},"/api/v1/agents/token-risk/contract-permissions":{"post":{"operationId":"tokenRiskContractPermissions","tags":["Token Risk"],"summary":"合约权限检查","description":"返回蜜罐、增发、暂停、黑名单、代理等第三方检测标记，未知保留null。 子接口共享完整采集和60秒缓存，仅缩小返回范围；服务器数据与网页浏览器回退结果可能不同。","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenInput"},"example":{"chain":"ethereum","token_address":"0xdac17f958d2ee523a2206206994597c13d831ec7"}}}},"responses":{"200":{"description":"请求成功；status可能为partial，请检查warnings及meta.coverage","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Envelope"},{"type":"object","properties":{"data":{"type":"object","properties":{"token":{"$ref":"#/components/schemas/Token"},"module":{"const":"contract_permissions"},"result":{"$ref":"#/components/schemas/ContractPermissionsModule"},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}}},"required":["token","module","result","sources"]}},"required":["data"]}]}}}},"400":{"description":"参数或JSON错误","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"Agent或接口不存在","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"405":{"description":"方法不支持","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"413":{"description":"请求体过大","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"415":{"description":"Content-Type错误","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"429":{"description":"频率超限","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"本版本为60秒"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"500":{"description":"内部错误","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"501":{"description":"Agent仍在规划中","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"502":{"description":"分析服务错误","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"503":{"description":"所请求模块全部数据不足，data仍保留覆盖说明","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}}}}},"/api/v1/agents/token-risk/fund-flows":{"post":{"operationId":"tokenRiskFundFlows","tags":["Token Risk"],"summary":"资金流观察","description":"返回转账样本中的地址净变化、增发/销毁和管理员大额转出线索，以及已覆盖的大额DEX买卖差。 子接口共享完整采集和60秒缓存，仅缩小返回范围；服务器数据与网页浏览器回退结果可能不同。","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenInput"},"example":{"chain":"ethereum","token_address":"0xdac17f958d2ee523a2206206994597c13d831ec7"}}}},"responses":{"200":{"description":"请求成功；status可能为partial，请检查warnings及meta.coverage","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Envelope"},{"type":"object","properties":{"data":{"type":"object","properties":{"token":{"$ref":"#/components/schemas/Token"},"module":{"const":"abnormal_flows"},"result":{"$ref":"#/components/schemas/FundFlowsModule"},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}}},"required":["token","module","result","sources"]}},"required":["data"]}]}}}},"400":{"description":"参数或JSON错误","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"Agent或接口不存在","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"405":{"description":"方法不支持","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"413":{"description":"请求体过大","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"415":{"description":"Content-Type错误","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"429":{"description":"频率超限","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"本版本为60秒"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"500":{"description":"内部错误","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"501":{"description":"Agent仍在规划中","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"502":{"description":"分析服务错误","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"503":{"description":"所请求模块全部数据不足，data仍保留覆盖说明","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}}}}},"/api/v1/agents/etf-flows/analyze":{"post":{"operationId":"etfFlowsAnalyze","tags":["ETF Flows"],"summary":"查询BTC/ETH美国现货ETF最新、近5/20交易日净资金流","description":"窗口包含reference_date，按美股交易日而非自然日；不混拼来源，不把缺失当零。返回USD字符串、方向、完整度、逐日记录及署名。最近已收盘日与最新披露日分开；缓存15分钟。公开来源受限时503，不提供模拟数值。","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EtfInput"},"example":{"asset":"btc"}}}},"responses":{"200":{"description":"查询结果，请检查窗口完整度、披露日期和warnings","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Envelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/EtfReport"}},"required":["data"]}]}}}},"400":{"description":"参数或JSON错误","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"Agent或接口不存在","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"405":{"description":"方法不支持","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"413":{"description":"请求体过大","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"415":{"description":"Content-Type错误","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"429":{"description":"频率超限","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"本版本为60秒"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"500":{"description":"内部错误","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"501":{"description":"Agent仍在规划中","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"502":{"description":"分析服务错误","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"503":{"description":"所请求模块全部数据不足，data仍保留覆盖说明","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}}}}},"/api/v1/agents/fear-greed/analyze":{"post":{"operationId":"fearGreedAnalyze","tags":["Fear and Greed"],"summary":"查询BTC恐惧与贪婪指数及历史对比","description":"Alternative.me官方公开指数，无需注册。保留原始情绪分类，按最新披露日的UTC自然日回溯1/7/30日；缺失不补零，变化单位为点。缓存15分钟，超过48小时标记stale，上游不可用返回503。引用数值时须在旁标明Alternative.me。","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FearGreedInput"},"example":{"asset":"btc"}}}},"responses":{"200":{"description":"最新指数、对比、最多31条日历史、来源及数据时效","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Envelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/FearGreedReport"}},"required":["data"]}]}}}},"400":{"description":"参数或JSON错误","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"Agent或接口不存在","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"405":{"description":"方法不支持","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"413":{"description":"请求体过大","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"415":{"description":"Content-Type错误","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"429":{"description":"频率超限","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"本版本为60秒"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"500":{"description":"内部错误","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"501":{"description":"Agent仍在规划中","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"502":{"description":"分析服务错误","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"503":{"description":"所请求模块全部数据不足，data仍保留覆盖说明","headers":{},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}}}}}},"components":{"schemas":{"AgentDescriptor":{"type":"object","properties":{"id":{"type":"string","description":"全局唯一小写kebab-case标识，如token-risk"},"name":{"type":"string","description":"中文显示名"},"version":{"type":["string","null"],"description":"Agent实现的语义版本；规划中为null"},"status":{"enum":["live","planned"]},"callable":{"type":"boolean","description":"只有true才可以调用；planned元数据不承诺路径已上线"},"chains":{"type":"array","items":{"type":"string"}},"authentication":{"type":"string","description":"当前public_preview表示无API Key的公共预览"},"operations":{"type":"array","items":{"type":"object","properties":{"operation_id":{"type":"string","description":"OpenAPI operationId"},"name":{"type":"string","description":"功能名"},"method":{"const":"POST"},"path":{"type":"string","description":"请求路径"},"description":{"type":"string","description":"功能说明"},"module":{"type":["string","null"]}},"required":["operation_id","name","method","path","description","module"]}},"input":{"type":"object","additionalProperties":{"type":"string"}},"limitations":{"type":"array","items":{"type":"string"}},"phase":{"type":"integer"},"purpose":{"type":"string","description":"未来Agent用途"},"proposed_operation":{"type":"string","description":"草案路径，不可调用"},"proposed_input":{"type":"object","additionalProperties":{"type":"string"}},"proposed_output":{"type":"array","items":{"type":"string"}},"dependencies":{"type":"array","items":{"type":"string"}},"proposed_followups":{"type":"array","items":{"type":"string"}}},"required":["id","name","version","status","callable"]},"TokenInput":{"type":"object","properties":{"chain":{"enum":["ethereum","bsc"],"description":"必填。ethereum=Ethereum主网；bsc=BNB Smart Chain主网。不支持测试网。"},"token_address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"EVM地址；按chain区分网络，不能仅用币名识别"}},"required":["chain","token_address"],"additionalProperties":false},"Token":{"type":"object","properties":{"chain":{"enum":["ethereum","bsc"]},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"EVM地址；按chain区分网络，不能仅用币名识别"},"name":{"type":["string","null"],"description":"代币名称"},"symbol":{"type":["string","null"],"description":"代币符号"},"price_usd":{"type":["string","null"],"description":"来自池子报价的当前美元价格，未知为null"}},"required":["chain","address","name","symbol","price_usd"]},"Holder":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"EVM地址；按chain区分网络，不能仅用币名识别"},"raw_balance":{"type":"string","description":"最小单位的精确非负整数，不转为JavaScript Number"},"balance":{"type":["string","null"],"description":"GoPlus回退时可能返回的代币余额字符串，不能假定与raw_balance同单位"},"supply_pct":{"type":"string","description":"十进制数值字符串，可包含负号；用于展示的估值可能近似。精确原始余额见raw_balance。"},"tag":{"type":"string","description":"供应商标签，空字符串表示未标注，不能推断地址身份"},"source":{"type":"string","description":"供应商域名，可能仅存在于主数据源结果"},"is_locked":{"description":"原样保留供应商锁定标记；缺失表示未知","type":["string","integer","null"]}},"required":["address","supply_pct","tag"]},"Source":{"type":"object","properties":{"kind":{"type":"string","description":"来源用途：security/market/holders/transfers/gecko1/gecko2/trades:<pool>等"},"url":{"type":"string","format":"uri"},"fetched_at":{"type":"integer","description":"Unix秒，UTC绝对时间；显示时自行转换时区"},"status":{"enum":["ok","error"]},"error":{"type":"string","description":"失败时存在的上游错误摘要"}},"required":["url","fetched_at","status"]},"Pool":{"type":"object","properties":{"pair":{"type":"string","description":"池地址或协议池ID，可能为40或64位十六进制"},"dex":{"type":["string","null"],"description":"DEX标识"},"liquidity_usd":{"type":"string","description":"十进制数值字符串，可包含负号；用于展示的估值可能近似。精确原始余额见raw_balance。"},"volume_24h_usd":{"type":["number","string","null"],"description":"供应商报告的24h美元成交量；null为未知"}},"required":["pair","dex","liquidity_usd","volume_24h_usd"]},"HistoryPoint":{"type":"object","properties":{"status":{"enum":["observed","insufficient"]},"reason":{"type":"string","description":"无基准时的原因"},"baseline_at":{"type":"integer","description":"Unix秒，UTC绝对时间；显示时自行转换时区"},"change_pct":{"type":"string","description":"十进制数值字符串，可包含负号；用于展示的估值可能近似。精确原始余额见raw_balance。"},"compared_pools":{"type":"integer"},"pool_set_changed":{"type":"boolean"},"note":{"type":"string","description":"美元变化不等于撤池"}},"required":["status"]},"DexTrade":{"type":"object","properties":{"kind":{"const":"dex_trade"},"hash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"timestamp":{"type":"integer","description":"Unix秒，UTC绝对时间；显示时自行转换时区"},"pool":{"type":"string","description":"池地址或ID"},"wallet":{"type":["string","null"],"pattern":"^0x[0-9a-fA-F]{40}$","description":"EVM地址；按chain区分网络，不能仅用币名识别"},"direction":{"enum":["buy","sell"],"description":"相对于本次目标代币：买入/卖出，不是相对于池子的任意base资产"},"quantity":{"type":"string","description":"十进制数值字符串，可包含负号；用于展示的估值可能近似。精确原始余额见raw_balance。"},"usd":{"type":"string","description":"十进制数值字符串，可包含负号；用于展示的估值可能近似。精确原始余额见raw_balance。"},"valuation":{"const":"provider_trade_value"},"event_id":{"type":"string","description":"成交事件身份；同一交易可包含多个真实事件"},"source":{"type":"string","format":"uri"}},"required":["kind","hash","timestamp","pool","wallet","direction","quantity","usd","valuation","event_id","source"]},"Transfer":{"type":"object","properties":{"kind":{"const":"transfer"},"hash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"timestamp":{"type":"integer","description":"Unix秒，UTC绝对时间；显示时自行转换时区"},"from":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"EVM地址；按chain区分网络，不能仅用币名识别"},"to":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"EVM地址；按chain区分网络，不能仅用币名识别"},"quantity":{"type":"string","description":"依据代币decimals转换的数量字符串，原始数据未以浮点转换后再拼接"},"usd_estimate":{"type":["string","null"],"description":"按当前价格估算的美元金额；不是交易时点价值"},"valuation":{"enum":["current_price_estimate","unavailable"]},"event_index":{"type":["integer","string","null"]},"source":{"type":"string","format":"uri"}},"required":["kind","hash","timestamp","from","to","quantity","usd_estimate","valuation","event_index","source"]},"HoldersModule":{"type":"object","properties":{"status":{"type":"string","enum":["observed","partial","insufficient"],"description":"observed=该模块声明范围已获取；partial=部分覆盖；insufficient=没有足够数据。observed不代表资产安全。"},"reason":{"type":"string","description":"覆盖范围、缺口与解释"},"returned":{"type":"integer","minimum":0,"maximum":20},"required":{"const":20},"returned_holders_pct":{"type":["string","null"],"description":"返回地址持仓百分数之和；供应商占比可能已四舍五入，50表示50%"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Holder"}},"source":{"type":"string","description":"主来源域名"}},"required":["status","reason","returned","required","returned_holders_pct","items"]},"LiquidityModule":{"type":"object","properties":{"status":{"type":"string","enum":["observed","partial","insufficient"],"description":"observed=该模块声明范围已获取；partial=部分覆盖；insufficient=没有足够数据。observed不代表资产安全。"},"reason":{"type":"string","description":"覆盖范围、缺口与解释"},"current_usd":{"type":["string","null"],"description":"已覆盖池子美元流动性之和；null为未知，不是零"},"pool_count":{"type":"integer"},"pools":{"type":"array","items":{"$ref":"#/components/schemas/Pool"}},"changes":{"type":"object","properties":{"1h":{"$ref":"#/components/schemas/HistoryPoint"},"6h":{"$ref":"#/components/schemas/HistoryPoint"},"24h":{"$ref":"#/components/schemas/HistoryPoint"}},"required":["1h","6h","24h"]},"provider_pool_counts":{"type":"object","properties":{"dexscreener":{"type":"integer"},"geckoterminal":{"type":"integer"},"added_from_gecko":{"type":"integer"}},"required":["dexscreener","geckoterminal","added_from_gecko"]}},"required":["status","reason","current_usd","pool_count","pools","changes"]},"LargeTransactionsModule":{"type":"object","properties":{"status":{"type":"string","enum":["observed","partial","insufficient"],"description":"observed=该模块声明范围已获取；partial=部分覆盖；insufficient=没有足够数据。observed不代表资产安全。"},"reason":{"type":"string","description":"覆盖范围、缺口与解释"},"threshold_usd":{"const":"100000","description":"当前固定10万美元，不支持自定义参数"},"items":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/DexTrade"},{"$ref":"#/components/schemas/Transfer"}]}},"dex_trades":{"type":"array","items":{"$ref":"#/components/schemas/DexTrade"}},"transfers":{"type":"array","items":{"$ref":"#/components/schemas/Transfer"}},"recent_transfers":{"type":"array","items":{"$ref":"#/components/schemas/Transfer"}},"scanned_transfers":{"type":"integer"},"transfer_sample_from":{"type":["integer","null"],"description":"Unix秒，UTC绝对时间；显示时自行转换时区"},"transfer_sample_to":{"type":["integer","null"],"description":"Unix秒，UTC绝对时间；显示时自行转换时区"},"trade_pools_requested":{"type":"integer"},"trade_pools_succeeded":{"type":"integer"},"large_dex_trades_found":{"type":"integer"},"large_transfers_found":{"type":"integer"},"complete_24h":{"const":false,"description":"本版本始终false。items最多150条，两分类数组分别最多100条，found为截断前计数。"}},"required":["status","reason","threshold_usd","items","dex_trades","transfers","recent_transfers","scanned_transfers","transfer_sample_from","transfer_sample_to","trade_pools_requested","trade_pools_succeeded","large_dex_trades_found","large_transfers_found","complete_24h"]},"ContractPermissionsModule":{"type":"object","properties":{"status":{"type":"string","enum":["observed","partial","insufficient"],"description":"observed=该模块声明范围已获取；partial=部分覆盖；insufficient=没有足够数据。observed不代表资产安全。"},"reason":{"type":"string","description":"覆盖范围、缺口与解释"},"flags":{"type":"object","properties":{"is_honeypot":{"type":["string","null"],"enum":["0","1",null],"description":"1=检测到该能力/标记，0=供应商未检测到，null=未知，不能将null当作0"},"cannot_sell_all":{"type":["string","null"],"enum":["0","1",null],"description":"1=检测到该能力/标记，0=供应商未检测到，null=未知，不能将null当作0"},"is_blacklisted":{"type":["string","null"],"enum":["0","1",null],"description":"1=检测到该能力/标记，0=供应商未检测到，null=未知，不能将null当作0"},"is_mintable":{"type":["string","null"],"enum":["0","1",null],"description":"1=检测到该能力/标记，0=供应商未检测到，null=未知，不能将null当作0"},"transfer_pausable":{"type":["string","null"],"enum":["0","1",null],"description":"1=检测到该能力/标记，0=供应商未检测到，null=未知，不能将null当作0"},"owner_change_balance":{"type":["string","null"],"enum":["0","1",null],"description":"1=检测到该能力/标记，0=供应商未检测到，null=未知，不能将null当作0"},"slippage_modifiable":{"type":["string","null"],"enum":["0","1",null],"description":"1=检测到该能力/标记，0=供应商未检测到，null=未知，不能将null当作0"},"hidden_owner":{"type":["string","null"],"enum":["0","1",null],"description":"1=检测到该能力/标记，0=供应商未检测到，null=未知，不能将null当作0"},"is_proxy":{"type":["string","null"],"enum":["0","1",null],"description":"1=检测到该能力/标记，0=供应商未检测到，null=未知，不能将null当作0"}},"required":["is_honeypot","cannot_sell_all","is_blacklisted","is_mintable","transfer_pausable","owner_change_balance","slippage_modifiable","hidden_owner","is_proxy"]},"tax_pct":{"type":"object","properties":{"buy_tax":{"type":["string","null"],"description":"买税百分数，10表示10%"},"sell_tax":{"type":["string","null"],"description":"卖税百分数，10表示10%"}},"required":["buy_tax","sell_tax"]},"owner_address":{"type":["string","null"],"description":"GoPlus返回的owner地址，可能空字符串/null，未知不推断"}},"required":["status","reason","flags","tax_pct","owner_address"]},"FundFlowsModule":{"type":"object","properties":{"status":{"type":"string","enum":["observed","partial","insufficient"],"description":"observed=该模块声明范围已获取；partial=部分覆盖；insufficient=没有足够数据。observed不代表资产安全。"},"reason":{"type":"string","description":"覆盖范围、缺口与解释"},"items":{"type":"array","items":{"type":"object","properties":{"type":{"enum":["mint","burn","admin_outflow"]},"message":{"type":"string","description":"需核实的观察线索，不是恶意行为定论"},"transaction":{"$ref":"#/components/schemas/Transfer"}},"required":["type","message","transaction"]}},"address_net_flows":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"EVM地址；按chain区分网络，不能仅用币名识别"},"net_quantity":{"type":"string","description":"十进制数值字符串，可包含负号；用于展示的估值可能近似。精确原始余额见raw_balance。"},"net_usd_estimate":{"type":["string","null"],"description":"当前价格估计净变化，正数流入负数流出"},"in_count":{"type":"integer"},"out_count":{"type":"integer"},"tag":{"type":"string","description":"供应商标签"}},"required":["address","net_quantity","net_usd_estimate","in_count","out_count","tag"]}},"sample_transfers":{"type":"integer"},"large_dex_buy_usd":{"type":["string","null"],"description":"覆盖范围内10万美元以上买入成交之和"},"large_dex_sell_usd":{"type":["string","null"],"description":"覆盖范围内10万美元以上卖出成交之和"},"large_dex_net_buy_usd":{"type":["string","null"],"description":"覆盖范围内大额买入减卖出；不是全链净流入，不与普通转账相加"}},"required":["status","reason","items","address_net_flows","sample_transfers","large_dex_buy_usd","large_dex_sell_usd","large_dex_net_buy_usd"]},"Finding":{"type":"object","properties":{"severity":{"enum":["medium","high","critical"]},"message":{"type":"string","description":"风险线索"},"evidence":{"type":"object","additionalProperties":true}},"required":["severity","message","evidence"]},"Report":{"type":"object","properties":{"schema_version":{"type":"string","description":"数据结构版本，目前0.2"},"rules_version":{"type":"string","description":"风控规则版本，目前0.2"},"generated_at":{"type":"integer","description":"Unix秒，UTC绝对时间；显示时自行转换时区"},"runtime":{"type":"string","description":"服务运行位置"},"token":{"$ref":"#/components/schemas/Token"},"assessment":{"type":"object","properties":{"status":{"const":"incomplete"},"observed_risk_level":{"enum":["undetermined","medium","high","critical"]},"findings_count":{"type":"integer"},"summary":{"type":"string","description":"风险等级仅代表已发现风险，不代表整体安全结论"}},"required":["status","observed_risk_level","findings_count","summary"]},"modules":{"type":"object","properties":{"holders_top20":{"$ref":"#/components/schemas/HoldersModule"},"liquidity":{"$ref":"#/components/schemas/LiquidityModule"},"large_transactions_24h":{"$ref":"#/components/schemas/LargeTransactionsModule"},"contract_permissions":{"$ref":"#/components/schemas/ContractPermissionsModule"},"abnormal_flows":{"$ref":"#/components/schemas/FundFlowsModule"}},"required":["holders_top20","liquidity","large_transactions_24h","contract_permissions","abnormal_flows"]},"findings":{"type":"array","items":{"$ref":"#/components/schemas/Finding"}},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}},"notice":{"type":"string","description":"分析局限说明"},"precision_note":{"type":"string","description":"余额和估值精度说明"},"cache":{"$ref":"#/components/schemas/Cache"}},"required":["schema_version","rules_version","generated_at","runtime","token","assessment","modules","findings","sources","notice","precision_note","cache"]},"Cache":{"type":"object","properties":{"hit":{"type":"boolean"},"ttl_seconds":{"type":"integer","enum":[60,900],"description":"token-risk为60秒；etf-flows为900秒"}},"required":["hit","ttl_seconds"]},"Error":{"type":"object","properties":{"code":{"type":"string","description":"稳定的机器错误码，调用方不要依赖中文message判断分支"},"message":{"type":"string","description":"中文错误说明"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","description":"错误字段"},"message":{"type":"string","description":"字段问题"}},"required":["field","message"]}},"retryable":{"type":"boolean"}},"required":["code","message","details","retryable"]},"Envelope":{"type":"object","properties":{"request_id":{"type":"string","format":"uuid"},"api_version":{"const":"1"},"agent":{"oneOf":[{"type":"null"},{"type":"object","properties":{"id":{"type":"string","description":"Agent ID"},"version":{"type":"string","description":"Agent实现版本"}},"required":["id","version"]}]},"status":{"enum":["completed","partial","error"],"description":"请求处理结果，与合约是否安全无关"},"data":{},"meta":{"type":"object","properties":{"generated_at":{"type":"integer","description":"Unix秒，UTC绝对时间；显示时自行转换时区"},"cache":{"$ref":"#/components/schemas/Cache"},"data_path":{"const":"server"},"schema_version":{"type":"string"},"rules_version":{"type":"string"},"coverage":{"type":"object","additionalProperties":{"type":"string","enum":["observed","partial","insufficient"],"description":"observed=该模块声明范围已获取；partial=部分覆盖；insufficient=没有足够数据。observed不代表资产安全。"}}}},"warnings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"DATA_UNAVAILABLE / PARTIAL_COVERAGE / NOT_FULL_24H"},"module":{"type":"string","description":"可选，报告模块名"},"message":{"type":"string","description":"覆盖警告"}},"required":["code","message"]}},"error":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/Error"}]}},"required":["request_id","api_version","agent","status","data","meta","warnings","error"]},"EtfInput":{"type":"object","properties":{"asset":{"type":"string","enum":["btc","eth","BTC","ETH"],"description":"必填，支持美国现货BTC/ETH ETF，输出统一小写"}},"required":["asset"],"additionalProperties":false},"EtfDay":{"type":"object","properties":{"date":{"type":"string","format":"date","description":"美国交易日YYYY-MM-DD，不按UTC时间戳换日"},"net_flow_usd":{"type":["string","null"],"description":"有符号美元金额，保留两位小数；null表示尚未披露/缺失，不是零"},"reporting_status":{"enum":["reported","pending","provisional","missing"]}},"required":["date","net_flow_usd","reporting_status"]},"EtfPeriod":{"type":"object","properties":{"requested_trading_days":{"type":"integer","enum":[1,5,20]},"observed_trading_days":{"type":"integer"},"start_date":{"type":"string","format":"date"},"end_date":{"type":"string","format":"date"},"net_flow_usd":{"type":["string","null"],"description":"窗口全部日期有值时的累计净流；任一天缺失则为null"},"observed_net_flow_usd":{"type":"string","description":"十进制数值字符串，可包含负号；用于展示的估值可能近似。精确原始余额见raw_balance。"},"direction":{"enum":["inflow","outflow","flat","unknown"]},"status":{"enum":["complete","partial","provisional"]},"inflow_days":{"type":"integer"},"outflow_days":{"type":"integer"},"flat_days":{"type":"integer"},"missing_dates":{"type":"array","items":{"type":"string","format":"date"}},"daily":{"type":"array","items":{"$ref":"#/components/schemas/EtfDay"}}},"required":["requested_trading_days","observed_trading_days","start_date","end_date","net_flow_usd","observed_net_flow_usd","direction","status","inflow_days","outflow_days","flat_days","missing_dates","daily"]},"EtfReport":{"type":"object","properties":{"asset":{"enum":["btc","eth"]},"market":{"const":"us_spot"},"currency":{"const":"USD"},"latest_trading_day":{"type":"string","format":"date","description":"按纽约时间计算的最近已收盘美股交易日，不保证数据已发布"},"latest_available_date":{"type":["string","null"],"format":"date","description":"已取到非空金额的最近日期"},"reference_date":{"type":["string","null"],"format":"date","description":"选定来源的最新记录日期，三组窗口均以该日为结束日期"},"periods":{"type":"object","properties":{"latest":{"oneOf":[{"$ref":"#/components/schemas/EtfPeriod"},{"type":"null"}]},"last_5":{"oneOf":[{"$ref":"#/components/schemas/EtfPeriod"},{"type":"null"}]},"last_20":{"oneOf":[{"$ref":"#/components/schemas/EtfPeriod"},{"type":"null"}]}},"required":["latest","last_5","last_20"]},"daily":{"type":"array","items":{"$ref":"#/components/schemas/EtfDay"}},"selected_source":{"type":["object","null"],"properties":{"provider":{"type":"string"},"url":{"type":"string","format":"uri"},"attribution":{"type":"string"},"fetched_at":{"type":"integer","description":"Unix秒，UTC绝对时间；显示时自行转换时区"},"updated_at":{"type":["string","null"]}}},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}},"status":{"enum":["completed","partial","unavailable"]},"warnings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"generated_at":{"type":"integer","description":"Unix秒，UTC绝对时间；显示时自行转换时区"},"cache":{"$ref":"#/components/schemas/Cache"},"methodology":{"type":"string"}},"required":["asset","market","currency","latest_trading_day","latest_available_date","reference_date","periods","daily","selected_source","sources","status","warnings","generated_at"]},"FearGreedInput":{"type":"object","properties":{"asset":{"type":"string","enum":["btc","BTC"],"description":"必填，仅支持BTC"}},"required":["asset"],"additionalProperties":false},"FearGreedPoint":{"type":"object","properties":{"date":{"type":"string","format":"date","description":"UTC自然日"},"timestamp":{"type":"integer","description":"Unix秒，UTC绝对时间；显示时自行转换时区"},"value":{"type":"integer","minimum":0,"maximum":100},"classification":{"enum":["Extreme Fear","Fear","Neutral","Greed","Extreme Greed"]},"classification_zh":{"type":"string","description":"来源分类的中文翻译"}},"required":["date","timestamp","value","classification","classification_zh"]},"FearGreedComparison":{"type":"object","properties":{"date":{"type":"string","format":"date"},"value":{"type":["integer","null"],"minimum":0,"maximum":100},"classification":{"type":["string","null"],"description":"原始分类，缺失为null"},"classification_zh":{"type":["string","null"],"description":"中文分类"},"change_points":{"type":["integer","null"],"description":"最新指数减该日指数，单位点，非百分比"}},"required":["date","value","classification","classification_zh","change_points"]},"FearGreedReport":{"type":"object","properties":{"asset":{"const":"btc"},"index_name":{"type":"string","description":"指数名称"},"scale":{"type":"object","properties":{"min":{"const":0},"max":{"const":100}},"required":["min","max"]},"latest":{"$ref":"#/components/schemas/FearGreedPoint"},"comparisons":{"type":"object","properties":{"yesterday":{"$ref":"#/components/schemas/FearGreedComparison"},"last_week":{"$ref":"#/components/schemas/FearGreedComparison"},"last_month":{"$ref":"#/components/schemas/FearGreedComparison"}},"required":["yesterday","last_week","last_month"]},"history":{"type":"array","items":{"$ref":"#/components/schemas/FearGreedPoint"}},"history_days":{"type":"integer","maximum":31},"stale":{"type":"boolean","description":"最新指数超过48小时"},"source":{"type":"object","properties":{"name":{"const":"Alternative.me"},"url":{"type":"string","format":"uri"},"api_url":{"type":"string","format":"uri"},"attribution":{"type":"string","description":"展示数值时须邻近保留的来源署名"},"fetched_at":{"type":"integer","description":"Unix秒，UTC绝对时间；显示时自行转换时区"}},"required":["name","url","api_url","attribution","fetched_at"]},"methodology":{"type":"string","description":"数据口径"},"generated_at":{"type":"integer","description":"Unix秒，UTC绝对时间；显示时自行转换时区"},"status":{"enum":["completed","partial"]},"warnings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"警告码"},"message":{"type":"string","description":"说明"}},"required":["code","message"]}},"cache":{"$ref":"#/components/schemas/Cache"}},"required":["asset","index_name","scale","latest","comparisons","history","history_days","stale","source","methodology","generated_at","status","warnings","cache"]}}},"x-legacy-api":{"path":"GET /api/analyze?chain=ethereum&address=0x...","status":"compatibility-only","notes":"旧接口维持原始响应供现有网页使用，新应用使用/api/v1。未设停用日期。"},"x-error-codes":["INVALID_JSON","INVALID_ARGUMENT","UNSUPPORTED_MEDIA_TYPE","PAYLOAD_TOO_LARGE","METHOD_NOT_ALLOWED","RATE_LIMITED","AGENT_NOT_FOUND","AGENT_NOT_AVAILABLE","NOT_FOUND","UPSTREAM_ERROR","UPSTREAM_UNAVAILABLE","INTERNAL_ERROR"]}