Signed token verdict, submittable to the trust oracle
What the avee trust oracle holds for one token, signed (EIP-712) so it can be submitted to AveeTrustOracle.submitAttestation or carried in a Uniswap v4 hookData. No key, no payment: a verdict nobody can read is a verdict nobody can act on.
Read status and the signature together. ok means the oracle holds no block — it is not a clearance, and it never means the token was examined and found clean. A token nobody has evaluated answers 200 with status: "unknown" and no signature block at all, because a signed zero would be a claim nobody made. Chains with no oracle answer the same way, with oracle_address absent.
verdict_at is when the verdict was reached; signed_at is when this response was signed and is the value the signature covers. An attestation can only tighten a verdict on chain: it may raise a status or set one where none exists, never lower one the relayer wrote.
Path Parameters
chain slug (ton) or numeric chain id (950000)
1 <= length <= 32chain-native address; EVM addresses are case-insensitive
1 <= length <= 128Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/chains/string/tokens/string/verdict"{ "token_address": "string", "chain": "hyperliquid", "chain_id": 0, "status": "string", "reasons": [ "string" ], "reason_bits": 0, "verdict_at": "string", "signed_at": "string", "expires_at": "string", "signature": "string", "signer": "string", "oracle_address": "string"}Top pairs of a token by 24h volume GET
The markets a token trades in on one chain, spot and perp, holding it on either leg, highest 24h volume first. Blocked pairs never appear. An empty list means no qualifying market, not an unknown token.
Merkle proof of a verdict at the last published epoch GET
The audit path, and the companion to the verdict. It answers "what did avee commit to at epoch N", never "is this token blocked now" — for that, read the verdict, or `isBlocked` on the oracle contract. Verify the returned path with `AveeTrustOracle.verifyLeaf(epoch, token, verdict, proof)`. No key, for the same reason the verdict needs none: a commitment nobody can check is not a commitment. A token absent from the published epoch is `404` — it was not committed to, which is a different fact from being committed to as unblocked.