Token - Security

curl --request GET \
  --url https://public-api.birdeye.so/defi/token_security \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://public-api.birdeye.so/defi/token_security', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "creatorAddress": "9AhKqLR67hwapvG8SA2JFXaCshXc9nALJjpKaHZrsbkw",
    "creatorOwnerAddress": null,
    "ownerAddress": null,
    "ownerOfOwnerAddress": null,
    "creationTx": "2K5X6HT9QZ8dcApbWL6mzYw6WBDvL5vWndTpGrFkQuMfuStGTP5LxPNQnnn5v5KR2T6UD1zEXnfCdajzUfuCPZgS",
    "creationTime": 1670531612,
    "creationSlot": 165714665,
    "mintTx": "44Jfxh3VFp6N2h3CLMGeHHxeexdtUnHRsvQ2QXF9h9JqHiBvjt2xCbJg7G443hPVvG4y5VP95iaiSRKuLVVcadCe",
    "mintTime": 1683780182,
    "mintSlot": 193273646,
    "creatorBalance": 48343.76164,
    "ownerBalance": null,
    "ownerPercentage": null,
    "creatorPercentage": 5.44198858929173e-10,
    "metaplexUpdateAuthority": "9AhKqLR67hwapvG8SA2JFXaCshXc9nALJjpKaHZrsbkw",
    "metaplexOwnerUpdateAuthority": null,
    "metaplexUpdateAuthorityBalance": 48343.76164,
    "metaplexUpdateAuthorityPercent": 5.44198858929173e-10,
    "mutableMetadata": true,
    "top10HolderBalance": 27020571907755.746,
    "top10HolderPercent": 0.3041667404641445,
    "top10UserBalance": 27020571907755.746,
    "top10UserPercent": 0.3041667404641445,
    "isTrueToken": null,
    "fakeToken": null,
    "totalSupply": 88834735403757.8,
    "preMarketHolder": [],
    "lockInfo": null,
    "freezeable": null,
    "freezeAuthority": null,
    "transferFeeEnable": null,
    "transferFeeData": null,
    "isToken2022": false,
    "nonTransferable": null,
    "jupStrictList": true
  },
  "success": true
}

GET

defi

token_security

Token - Security

curl --request GET \
  --url https://public-api.birdeye.so/defi/token_security \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://public-api.birdeye.so/defi/token_security', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "creatorAddress": "9AhKqLR67hwapvG8SA2JFXaCshXc9nALJjpKaHZrsbkw",
    "creatorOwnerAddress": null,
    "ownerAddress": null,
    "ownerOfOwnerAddress": null,
    "creationTx": "2K5X6HT9QZ8dcApbWL6mzYw6WBDvL5vWndTpGrFkQuMfuStGTP5LxPNQnnn5v5KR2T6UD1zEXnfCdajzUfuCPZgS",
    "creationTime": 1670531612,
    "creationSlot": 165714665,
    "mintTx": "44Jfxh3VFp6N2h3CLMGeHHxeexdtUnHRsvQ2QXF9h9JqHiBvjt2xCbJg7G443hPVvG4y5VP95iaiSRKuLVVcadCe",
    "mintTime": 1683780182,
    "mintSlot": 193273646,
    "creatorBalance": 48343.76164,
    "ownerBalance": null,
    "ownerPercentage": null,
    "creatorPercentage": 5.44198858929173e-10,
    "metaplexUpdateAuthority": "9AhKqLR67hwapvG8SA2JFXaCshXc9nALJjpKaHZrsbkw",
    "metaplexOwnerUpdateAuthority": null,
    "metaplexUpdateAuthorityBalance": 48343.76164,
    "metaplexUpdateAuthorityPercent": 5.44198858929173e-10,
    "mutableMetadata": true,
    "top10HolderBalance": 27020571907755.746,
    "top10HolderPercent": 0.3041667404641445,
    "top10UserBalance": 27020571907755.746,
    "top10UserPercent": 0.3041667404641445,
    "isTrueToken": null,
    "fakeToken": null,
    "totalSupply": 88834735403757.8,
    "preMarketHolder": [],
    "lockInfo": null,
    "freezeable": null,
    "freezeAuthority": null,
    "transferFeeEnable": null,
    "transferFeeData": null,
    "isToken2022": false,
    "nonTransferable": null,
    "jupStrictList": true
  },
  "success": true
}

Usage Note
Accessibility
Chain Supported

Token-level security and risk context.

Use this endpoint when you need safety signals before listing, surfacing, or trading a token.
Designed for token review and risk scoring, not price or holder analytics.

Compute Unit ⚙️

This endpoint consumes 25 CU per request.

Use Cases 💡

Add safety context to token pages, scanners, and listing workflows.
Flag risky tokens before bots, alerts, or trading automations react to them.
Feed internal risk review or trust-scoring pipelines.

How to Use 🛠️

Set x-chain for a supported non-Sui network.
Pass the token address.
Combine the result with price, liquidity, and holder data for a fuller decision picture.

Best Practices ✅

Treat security data as one input in a broader review, not a standalone trading signal.
Run this endpoint early for newly discovered tokens before deeper downstream analysis.

Authorizations

X-API-KEY

string

header

required

API key for authentication

Headers

x-chain

enum<string>

default:solana

A chain name listed in supported networks except Sui.

Available options:

solana,

ethereum,

bsc,

base,

robinhood,

mantle,

hyperevm,

arbitrum,

avalanche,

optimism,

polygon,

zksync,

monad,

aptos,

fogo,

megaeth

Query Parameters

address

string

required

The address of the token contract.

Response

JSON object containing a security information of a token

success

boolean

required

Whether the request succeeded.

data

object

required

Token security profile. Returned shape depends on the chain family.

Option 1
Option 2

Show child attributes