How do I get an API key?
Create an account, verify your email and issue a key yourself in the dashboard, under API keys. The secret is shown once at creation — store it then, because traql doesn't keep a copy to show you again. You can rotate or revoke a key at any time from the same screen.
How much does a call cost?
With an account, a call spends one check from your balance — 3 checks are free on signup, and packs bring the price down to $0.20 per check at volume. Without an account, you can pay per call in USDC over x402: $0.50 for an address check, $1.00 for a transaction check.
Is there an SDK?
No. There are two REST endpoints — check an address, check a transaction — authenticated with a plain X-API-Key header. If your language can send a JSON POST and read a JSON response, you don't need a client library.
Do API keys and the web checker share the same balance?
Yes. Your account holds one balance of checks, and it doesn't matter whether you spend it in the browser or through an API key — there's nothing separate to top up.
What is x402, and when do I need it?
x402 is a way to pay per call in USDC on Base without an account or an API key — useful for an autonomous agent that has a funded wallet but no human to sign up. Call the endpoint with no key, get back a 402 with a payment challenge, settle it, and the verdict comes back on the retry. The response is a summary verdict rather than the full itemised reasons, and it costs more per check than any pack — that's the trade for skipping the account.
Which networks are supported?
Bitcoin, Ethereum, BNB Smart Chain, TRON and TON. Scoring is chain-scoped: the same address string is assessed independently on each network you check it on.
What does the response contain?
A score from 0 to 100, a risk band, a list of flags, and a reasons array — each reason names its source, the entity behind it and its category. The full response also carries severity and confidence per reason. The interactive reference at api.traql.io/docs has the complete schema and lets you try a call from the browser.