Is a token safe
const url = 'https://api.getchord.xyz/v1/security/token/example/example';const options = {method: 'GET'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://api.getchord.xyz/v1/security/token/example/exampleChord’s safety report for one token: the same report the Ask analyst, the trade dock and the trade card read.
What runs: on the EVM chains, Chord’s own contract scan (proxy wiring and who can upgrade it, the owner and what the owner can do: mint, block wallets, pause, change taxes or limits), a $20 buy and its sell back through Chord’s router simulated as a test wallet (nothing is sent), the transfer-tax probe, GoPlus, Sourcify and Chord’s own tape screen (wash trading, buyer clusters, rugs, buyers who cannot sell, a copied ticker). On Solana: RugCheck, GoPlus, Jupiter and the screen of Chord’s Solana tape (mint and freeze authority, Token-2022 extensions, LP lock, holders, the creator’s history). A source that does not answer leaves its checks unknown and the report partial; it is never read as a pass.
Use it for: “is this token safe to buy”, a rug or honeypot check before a trade, an agent’s pre-trade gate (refuse avoid, warn on caution).
Notes
- Cached 10 minutes (2 to 3 minutes when a source did not answer, seconds when nothing could test selling an unvetted token or the check was cut short on Chord’s side; such a partial report is sent
Cache-Control: private, max-age=10). A report built cold on an EVM chain can take up to about 20 seconds. An address with no contract answers 404 at once. - A report already cached answers anyone. Without an API key (or an Ask session), one IP builds at most 10 new reports every 10 minutes, and every such caller together a limited number a minute; past either the answer is 429 or 503
BUSYwithRetry-After, and nothing is checked. Send anX-API-Keyfor more. verdictis decided in code fromchecks. No verdict rests on GoPlus alone: when only GoPlus answered, the report ispartialand says Chord’s own checks did not run. A reading from GoPlus names it “GoPlus (Powered by Go+ Security)”.- A Solana mint is used exactly as given (base58 is case-sensitive).
Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters”Chain id or name: 1 / ethereum, 56 / bnb, 143 / monad, 4663 / robinhood, 5042 / arc, 8453 / base, 42161 / arbitrum, 43114 / avalanche, or solana.
The token contract (0x followed by 40 hex characters), or the Solana mint exactly as written (base58, 32 bytes).
Responses
Section titled “ Responses ”The report.
Chord’s safety report for one token.
object
The token (0x, lower-cased) or the Solana mint (case kept).
As the contract or the token list names it: chosen by whoever launched the token.
Decided in code from the checks, never by a model. avoid: it cannot be sold, a sell tax of 30% or more, a scam verdict of Chord’s tape screen, or a copy of a listed token’s ticker. caution: a check that warns (taxes of 5 to 30%, an owner who can mint, block wallets or pause, code one wallet can upgrade, unverified source, unlocked liquidity one provider can pull, top 10 holders over 60% …). ok: none of that, with two independent sources answering and a sell test passing. unknown: too few sources, or nothing could test selling it. Never read ok as a guarantee.
0 (worst) to 100, in the verdict’s band; null when the verdict is unknown.
Every check, in a fixed order.
One check of the report.
object
Stable id, snake_case: honeypot, buy_tax, sell_tax, transfer_tax, round_trip, owner_can_mint, blacklist, pausable, owner_privileges, hidden_owner, proxy_upgradeable, unverified_source, lp_unlocked, top10_holders, creator_holds, creator_history, tape_screen, impostor_ticker, own_checks …; Solana adds freeze_authority, mint_authority, token2022_extensions, mutable_metadata, liquidity …
Short English label (Sell tax, Owner can mint).
unknown = the source that reads it did not answer, or nothing could test it. Never pass for a check that did not run.
One sentence with the measured number (Selling loses 40% to the token's own tax (Chord simulation 40%, GoPlus 40%).).
Who read it, in words, at most 60 characters (Chord simulation, Chord contract scan, Chord tape, RugCheck, Sourcify). A reading from GoPlus says GoPlus (Powered by Go+ Security).
The numbers behind the checks: buyTaxPct, sellTaxPct, transferTaxPct, honeypot, owner, ownerRenounced, proxy, implementation, upgrader, verifiedSource, mintable, blacklist, pausable, lpLockedPct, top10Pct, holders, creator, creatorPct, screenLevel, screenReasons, simulation (Chord’s $20 buy and sell back: status, taxes, round trip), reasons (the counted reasons, worst first), answered / missing (the sources), goplusOnly (only GoPlus answered: the report is partial). Solana adds mintAuthority, freezeAuthority, token2022Extensions, permanentDelegate, liquidityUsd, pools, topHolders, jupiterVerified, rugcheckScore …
object
Where to read it yourself (explorer, GoPlus, RugCheck, Sourcify, Jupiter).
object
Unix time, milliseconds — when the server built this answer.
True when at least one source did not answer, or when GoPlus was the only one that did.
On a list Chord trusts (stock / ETF / bridged list token, the bridge provider’s list, Monad’s verified list, a registry anchor; on Solana Jupiter-verified majors): the issuer’s own powers (mint, freeze, pause, upgrades) are listed but do not raise the verdict. Taxes and the sell test still count.
Example
{ "chain": "solana", "verdict": "avoid", "checks": [ { "status": "pass" } ]}UNSUPPORTED_CHAIN (a chain Chord does not check, or one not served yet) or INVALID_ADDRESS.
Every non-2xx body.
object
Stable machine code, e.g. INVALID_PARAMS, NOT_READY, RATE_LIMIT_EXCEEDED.
For humans.
HTTP status, when included.
Example
{ "error": "INVALID_PARAMS", "message": "amount must be an integer string in the token's smallest unit"}NOT_A_CONTRACT: the chain answered and there is no contract at this address. NOT_A_MINT: no Solana source knows this address as a token.
Every non-2xx body.
object
Stable machine code, e.g. INVALID_PARAMS, NOT_READY, RATE_LIMIT_EXCEEDED.
For humans.
HTTP status, when included.
Example
{ "error": "INVALID_PARAMS", "message": "amount must be an integer string in the token's smallest unit"}RATE_LIMITED: without an API key, this IP built its 10 new reports of the last 10 minutes (Retry-After); cached reports still answer. Or RATE_LIMIT_EXCEEDED, the per-minute limit of every route.
Every non-2xx body.
object
Stable machine code, e.g. INVALID_PARAMS, NOT_READY, RATE_LIMIT_EXCEEDED.
For humans.
HTTP status, when included.
Example
{ "error": "INVALID_PARAMS", "message": "amount must be an integer string in the token's smallest unit"}BUSY: too many new reports are being built for callers without a key right now (Retry-After). UNAVAILABLE: the check could not run just now. Retry; do not treat either as a clean result.
Every non-2xx body.
object
Stable machine code, e.g. INVALID_PARAMS, NOT_READY, RATE_LIMIT_EXCEEDED.
For humans.
HTTP status, when included.
Example
{ "error": "INVALID_PARAMS", "message": "amount must be an integer string in the token's smallest unit"}