{"slug":"agent-research-api-onrender-com-v1-token-brief-628ae4","title":"TokenBrief","host":"agent-research-api.onrender.com","method":"POST","resource":"https://agent-research-api.onrender.com/v1/token-brief","category":"market","description":"TokenBrief: Analyze a Base ERC-20 address with block-linked supply, owner/proxy observations and scoped Uniswap v3 pools (USDC/WETH). Returns spot quotes, pool inventory and evidence; share-card viewer at /tokenbrief. Optional narration=ai adds OpenAI commentary; default rules. No security verdict, ","price_listed":0.01,"price_asked":0.01,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":180,"reported_calls_30d":1,"reported_payers_30d":1,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"address":"0x4200000000000000000000000000000000000006"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"additionalProperties":false,"properties":{"address":{"pattern":"^0x[0-9a-fA-F]{40}$","type":"string"},"narration":{"default":"rules","enum":["rules","ai"],"type":"string"}},"required":["address"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"properties":{"billing":{"properties":{"amount_usdc":{"minimum":0,"type":"number"},"mode":{"enum":["local","staging","production"]},"status":{"enum":["settled","not_charged"]}},"required":["mode","status","amount_usdc"],"type":"object"},"cache_age_seconds":{"minimum":0,"type":"integer"},"conflicts":{"items":{"properties":{"evidence":{"items":{"properties":{"evidence_type":{"enum":["official_site_json_ld","official_site_meta_description","official_site_brand_metadata","official_site_logo","official_site_copyright"],"type":"string"},"retrieved_at":{"format":"date-time","type":"string"},"source_url":{"format":"uri","pattern":"^https://","type":"string"},"value":{"type":"string"}},"required":["value","source_url","evidence_type","retrieved_at"],"type":"object"},"type":"array"},"field":{"type":"string"}},"required":["field","evidence"],"type":"object"},"type":"array"},"data":{"properties":{"ai_commentary":{"anyOf":[{"properties":{"estimated_cost_micro_usd":{"type":"integer"},"evidence":{"items":{"type":"string"},"type":"array"},"headline":{"type":"string"},"model":{"type":"string"},"notice":{"type":"string"},"status":{"const":"generated"},"summary":{"type":"string"},"usage":{"properties":{"input_tokens":{"type":"integer"},"output_tokens":{"type":"integer"}},"required":["input_tokens","output_tokens"],"type":"object"}},"required":["status","model","headline","summary","evidence","usage","estimated_cost_micro_usd","notice"],"type":"object"},{"type":"null"}]},"analysis":{"properties":{"findings":{"items":{"properties":{"code":{"type":"string"},"evidence":{"items":{"type":"string"},"type":"array"},"level":{"enum":["attention","unknown"]},"text":{"type":"string"}},"required":["code","level","text","evidence"],"type":"object"},"type":"array"},"headline":{"type":"string"},"method":{"const":"deterministic-rules"},"summary":{"type":"string"},"version":{"type":"string"}},"required":["method","version","headline","summary","findings"],"type":"object"},"block":{"properties":{"finalized":{"const":false},"hash":{"type":"string"},"number":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"required":["number","hash","timestamp","finalized"],"type":"object"},"controls":{"properties":{"eip1967_beacon":{"anyOf":[{"pattern":"^0x[0-9a-fA-F]{40}$","type":"string"},{"type":"null"}]},"eip1967_implementation":{"anyOf":[{"pattern":"^0x[0-9a-fA-F]{40}$","type":"string"},{"type":"null"}]},"owner":{"anyOf":[{"pattern":"^0x[0-9a-fA-F]{40}$","type":"string"},{"type":"null"}]}},"required":["owner","eip1967_implementation","eip1967_beacon"],"type":"object"},"coverage":{"properties":{"attempted_queries":{"type":"integer"},"factory":{"pattern":"^0x[0-9a-fA-F]{40}$","type":"string"},"failed_queries":{"type":"integer"},"fee_tiers":{"items":{"type":"integer"},"type":"array"},"holder_concentration":{"const":"not_assessed"},"quote_assets":{"items":{"type":"string"},"type":"array"},"sellability":{"const":"not_assessed"},"venue":{"const":"uniswap-v3"}},"required":["venue","factory","quote_assets","fee_tiers","attempted_queries","failed_queries","holder_concentration","sellability"],"type":"object"},"limitations":{"items":{"type":"string"},"type":"array"},"observed_at":{"format":"date-time","type":"string"},"pools":{"items":{"properties":{"active_liquidity_raw":{"anyOf":[{"type":"string"},{"type":"null"}]},"address":{"pattern":"^0x[0-9a-fA-F]{40}$","type":"string"},"fee_bps":{"type":"number"},"quote_address":{"pattern":"^0x[0-9a-fA-F]{40}$","type":"string"},"quote_inventory":{"anyOf":[{"type":"string"},{"type":"null"}]},"quote_symbol":{"enum":["USDC","WETH"]},"source_url":{"format":"uri","type":"string"},"spot_quote":{"anyOf":[{"type":"string"},{"type":"null"}]},"token_inventory":{"anyOf":[{"type":"string"},{"type":"null"}]},"venue":{"const":"uniswap-v3"}},"required":["address","venue","fee_bps","quote_symbol","quote_address","spot_quote","active_liquidity_raw","token_inventory","quote_inventory","source_url"],"type":"object"},"maxItems":8,"type":"array"},"product":{"const":"TokenBrief"},"token":{"properties":{"address":{"pattern":"^0x[0-9a-fA-F]{40}$","type":"string"},"chain":{"const":"base"},"chain_id":{"const":8453},"decimals":{"maximum":36,"minimum":0,"type":"integer"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"total_supply":{"type":"string"},"total_supply_raw":{"type":"string"}},"required":["chain","chain_id","address","name","symbol","decimals","total_supply","total_supply_raw"],"type":"object"}},"required":["product","token","block","observed_at","pools","controls","coverage","analysis","limitations"],"type":"object"},"missing_fields":{"items":{"type":"string"},"type":"array"},"request_id":{"type":"string"},"retrieved_at":{"format":"date-time","type":"string"},"schema_version":{"const":"1.0"},"sources":{"items":{"properties":{"provider":{"type":"string"},"retrieved_at":{"format":"date-time","type":"string"},"url":{"format":"uri","pattern":"^https://","type":"string"}},"required":["retrieved_at"],"type":"object"},"type":"array"},"warnings":{"items":{"type":"string"},"type":"array"}},"required":["request_id","schema_version","data","sources","retrieved_at","missing_fields","conflicts","warnings","cache_age_seconds","billing"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-09-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.01,"price_match":true,"latency_ms":180,"error":null}],"description_full":"TokenBrief: Analyze a Base ERC-20 address with block-linked supply, owner/proxy observations and scoped Uniswap v3 pools (USDC/WETH). Returns spot quotes, pool inventory and evidence; share-card viewer at /tokenbrief. Optional narration=ai adds OpenAI commentary; default rules. No security verdict, holder concentration or sellability test. Cache up to 60s, disclosed. Source or AI failures are not settled.","last_updated":"2026-09-20T17:31:16.888Z","schemes":["exact"]}