apyhub
Back
▣ FINANCE · SECURITY & PRIVACY

Analyze Crypto Token Security Risks API

What it does

Token Risk Checker analyzes an ERC-20 style token contract for common scam and ownership risks. Send a blockchain address, optionally choose chain, and get back a risk assessment for that token on Ethereum, BSC, Polygon, Arbitrum, Optimism, Base, or Avalanche.

The response includes the token’s source, chain, and address, plus a numeric riskScore from 0 to 100 and a riskLevel of low, medium, or high. It also reports whether the contract is an isHoneypot and may include checks such as isProxy, isMintable, holderCount, isOpenSource, ownerAddress, buyTaxPercent, sellTaxPercent, isBlacklisted, lpHolderCount, transferPausable, and canTakeBackOwnership when available.

Use Token Risk Checker when you need to screen a token before trading, listing, or integrating it into a wallet or analytics app. It helps you flag suspicious contracts, detect potentially trapped liquidity scenarios, and surface ownership or tax settings that deserve a manual review.

GET
Token honeypot & risk check
https://api.eu.apyhub.com/corsair96/analyze-crypto-token-security-risks/crypto/token-risk

QUICKSTART

GUIDE

Quickstart

Check a token contract’s honeypot risk by passing its Ethereum address as a query parameter.

curl -X GET "https://api.eu.apyhub.com/corsair96/analyze-crypto-token-security-risks/crypto/token-risk?chain=ethereum&address=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with source (string), chain (string), address (string), riskScore (integer), riskLevel (low, medium, or high), and isHoneypot (boolean). It may also include fields like isProxy, isMintable, holderCount, isOpenSource, ownerAddress, buyTaxPercent, isBlacklisted, lpHolderCount, sellTaxPercent, transferPausable, and canTakeBackOwnership.

{
  "source": "honeypot.is",
  "chain": "ethereum",
  "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
  "riskScore": 1,
  "riskLevel": "low",
  "isHoneypot": false,
  "isOpenSource": null,
  "isMintable": null,
  "canTakeBackOwnership": null,
  "isBlacklisted": null,
  "transferPausable": null,
  "isProxy": null,
  "buyTaxPercent": 0,
  "sellTaxPercent": 0,
  "holderCount": 9099594,
  "lpHolderCount": null,
  "ownerAddress": null,
  "degraded": false
}
TRY ITLIVE · 120 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Checks a token contract address for honeypot and risk-related signals on the selected blockchain network. It returns a JSON object with the token’s chain, address, risk classification, risk score, honeypot flag, and additional token properties when available.

Query Parameter(s)

AttributeTypeMandatoryDescription
chainStringNoBlockchain to check.
Allowed values: ethereum, bsc, polygon, arbitrum, optimism, base, avalanche.
Default: ethereum.
addressStringYesToken contract address.
Format: 0x followed by 40 hexadecimal characters.

Response

Returns a JSON object with required source, chain, address, riskScore, riskLevel, and isHoneypot fields. The response also includes optional token-risk details such as isProxy, isMintable, holderCount, and other nullable indicators when available.

AttributeTypeDescription
sourceStringData source used for the check.
chainStringBlockchain network for the result.
addressStringToken contract address that was checked.
isProxyBoolean / NullWhether the token contract is a proxy contract, if available.
riskLevelENUMRisk classification.
Allowed values: low, medium, high.
riskScoreIntegerRisk score from 0 to 100.
isHoneypotBooleanWhether the token is identified as a honeypot.
isMintableBoolean / NullWhether the token is mintable, if available.
holderCountInteger / NullNumber of holders, if available.
isOpenSourceBoolean / NullWhether the contract source is open source, if available.
ownerAddressString / NullOwner address, if available.
buyTaxPercentNumberBuy tax percentage.
isBlacklistedBoolean / NullWhether blacklisting is enabled or detected, if available.
lpHolderCountInteger / NullNumber of liquidity pool holders, if available.
sellTaxPercentNumberSell tax percentage.
transferPausableBoolean / NullWhether transfers can be paused, if available.
canTakeBackOwnershipBoolean / NullWhether ownership can be taken back, if available.
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.