CRIUS Docs
API status Get API key
Security & liquidity

Security checks

Security: realized tax, simulated honeypot, contract checks

GET https://api.crius.sh/v1/{chain}/token/{address}/security
Anonymous and above (no key needed) 1 credit per call Runnable here Updated Oct 28, 2026

Contract checks (ownership, mint, pause, blacklist, proxy, limits), realized and simulated buy/sell tax, honeypot verdict and, for v4 tokens, the pool hook's permissions and risk. amount_usd sets the simulated trade size (default 100).

Realized tax (30 d), eth_simulateV1 buy → transfer → sell for V2-routed tokens, owner / proxy / capabilities / limits, hook risk, LP status, flags, score.

Path parameters

chainstringrequired

Chain slug (robinhood) or chain id (4663).

addressstringrequired

Contract or wallet address, any case (0x…, 20 bytes).

Query parameters

amount_usdnumber Default 100

Simulated trade size in USD.

freshinteger

1 runs a new simulation now (Starter plan and up, 20 credits).

Key response fields

  • risk (low / medium / high) and score (0–100), plus flags
  • honeypot.is_honeypot, honeypot.selective (only some wallets can sell), honeypot.reason
  • tax.buy_pct, tax.sell_pct and their source; tax.realized (from real trades, with sample counts and the highest sell tax seen) and tax.simulated
  • tax_history: every tax change with the block it took effect
  • contract: ownership, mintable, pausable, blacklist, proxy / upgradeable, can change tax or limits
  • hook: the v4 pool hook's name, permissions, capabilities, risk level and flags (with evidence), code, observed outcomes and code-family history. The score loses 60, 30 or 10 points for a critical, high or medium hook
  • liquidity.summary: locked, burned and unlocked shares of LP

Guides that use this endpoint

Errors

Errors come back as { "error": { "code", "message" } } with the matching HTTP status: 400 bad parameter, 401 missing or invalid key, 403 endpoint above your plan, 404 unknown token or address, 429 rate limit or credits used up (with Retry-After). See Errors.

More security & liquidity endpoints

Get your free Crius API key

Every example on this page works with a free key: higher rate limits than the anonymous plan, holders, wallets and the WebSocket stream. No card needed.

  • Robinhood Chain (4663) only, from our own archive nodes
  • REST + WebSocket
  • Pay on-chain or by card