vetagent

{'type': 'object', 'required': ['address'], 'properties': {'address': {'type': 'string', 'description': 'Token contract address: ERC-20 (0x + 40 hex) or Solana (base58)'}, 'verbose': {'type': 'boolean', 'default': False, 'description': 'Return full upstream evidence. Off by default to save tokens.'}, 'chain_hint': {'type': 'string', 'description': 'Optional chain name (ethereum / bsc / base / polygon / arbitrum / solana). Strongly recommended: Ethereum forks such as PulseChain inherit contract addresses, so the same address exists on several chains at wildly different prices. Without it, an answer covers one chain -- the one holding the most depth -- and names it.'}}}

{'type': 'object', 'required': ['address', 'risk_level', 'risk_score', 'confidence', 'signals'], 'properties': {'driver': {'type': ['object', 'null'], 'description': 'The signal that decided the verdict: {name, category}. null when nothing above ok fired.'}, 'address': {'type': 'string'}, 'signals': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'message': {'type': 'string'}, 'category': {'type': 'string'}, 'severity': {'enum': ['ok', 'info', 'warn', 'critical', 'fatal'], 'type': 'string'}}}}, 'evidence': {'type': 'object'}, 'checked_at': {'type': 'string', 'description': 'When this answer was made, ISO-8601 UTC.'}, 'confidence': {'enum': ['low', 'medium', 'high'], 'type': 'string', 'description': 'How complete the input data was — not how safe the token is.'}, 'risk_level': {'enum': ['low', 'medium', 'high', 'unknown'], 'type': 'string', 'description': "'unknown' means a critical check could not be completed. It is NOT a low-risk result and must not justify a trade."}, 'risk_score': {'type': 'integer', 'description': '0-100; higher is more dangerous'}, 'next_action': {'enum': ['retry', 'abstain'], 'type': 'string'}, 'unknown_kind': {'enum': ['infrastructure', 'coverage', 'mixed'], 'type': 'string', 'description': 'Present only when risk_level is unknown.'}, 'recommendation': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer'}, 'evidence_max_age_seconds': {'type': 'integer', 'description': 'Age of the oldest evidence used; 0 when every source answered live.'}}}

{'type': 'object', 'properties': {'chain': {'type': 'string', 'default': 'solana', 'description': 'Chain name, e.g. solana / ethereum / base / bsc'}, 'limit': {'type': 'integer', 'default': 10, 'maximum': 50, 'minimum': 1}}}

{'type': 'object', 'required': ['chain', 'network', 'count', 'scanned', 'sources_ok', 'sources_failed', 'pools'], 'properties': {'chain': {'type': 'string'}, 'count': {'type': 'integer', 'description': 'How many pools are in `pools`. NOT how many were examined -- that is `scanned`. This field reported the fetched total beside a shorter list until 2026-09-08, so a caller reading it believed it had seen twenty pools when it had three.'}, 'pools': {'type': 'array', 'items': {'type': 'object', 'required': ['pool_id', 'name', 'token_address', 'kind'], 'properties': {'kind': {'enum': ['new', 'trending'], 'type': 'string'}, 'name': {'type': 'string'}, 'pool_id': {'type': 'string'}, 'price_usd': {'type': ['number', 'null']}, 'liquidity_usd': {'type': ['number', 'null']}, 'pool_age_days': {'type': ['integer', 'null']}, 'token_address': {'type': 'string', 'description': 'The base token. This is the field to hand to assess_token_risk -- pool_id is not an address, and passing it produced six empty answers before the discovery-to-vetting seam was fixed.'}, 'volume_24h_usd': {'type': ['number', 'null']}}}}, 'network': {'type': 'string', 'description': "The upstream's own name for the chain, which differs from `chain` (eth vs ethereum)."}, 'scanned': {'type': 'integer', 'description': 'How many distinct pools were examined before the limit was applied. Always >= count.'}, 'checked_at': {'type': 'string', 'description': 'When this answer was made, ISO-8601 UTC.'}, 'sources_ok': {'type': 'array', 'items': {'enum': ['new', 'trending'], 'type': 'string'}, 'description': 'Which of the two upstream listings answered. Both means a full scan.'}, 'served_stale': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Present only when an upstream was unreachable and cached data was used. Each entry names the source and its age in seconds.'}, 'sources_failed': {'type': 'array', 'items': {'enum': ['new', 'trending'], 'type': 'string'}, 'description': 'Which listings did NOT answer. A non-empty array means this is a PARTIAL scan: a smaller `scanned` here is a coverage gap, not a quiet market. Treat it as missing information, not as absence.'}}, 'description': "Discovery only, never an endorsement. Call assess_token_risk on token_address before saying anything about a pool's risk."}

{'type': 'object', 'required': ['address'], 'properties': {'address': {'type': 'string', 'description': 'Token contract address'}, 'chain_hint': {'type': 'string', 'description': 'Optional chain name; disambiguates forks that share addresses'}}}

{'type': 'object', 'required': ['address', 'status'], 'properties': {'chains': {'type': 'array', 'items': {'type': 'string'}}, 'status': {'enum': ['ok', 'not_found', 'unpriced', 'drained', 'unavailable'], 'type': 'string'}, 'address': {'type': 'string'}, 'price_usd': {'type': 'number'}, 'checked_at': {'type': 'string', 'description': 'When this answer was made, ISO-8601 UTC.'}, 'pairs_total': {'type': 'integer'}, 'served_stale': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Present only when an upstream was unreachable and this answer used cached data. Each entry names the source and how many seconds old it was.'}, 'liquidity_usd': {'type': ['number', 'null']}, 'volume_24h_usd': {'type': 'number'}}}