Token security

Check token contract security, trading taxes and risk-summary fields.

GET/api/v1/risk/token-security
Domain
Risk & Compliance
Level
One token contract on one chain per request
MCP tool
risk_compliance_query (task=token_security)

Available data

Returns
Check token contract security, trading taxes and risk-summary fields.
What each request returns
One token contract on one chain per request

Authentication

Send Authorization: Bearer YOUR_API_KEY or X-API-KEY on every request.

Requires an API key with Risk permission.

Query Parameters

Query example
Contract identification

Both chain_id and address are required. Use a contract address, not a ticker

chain_idstringqueryExampleethereumrequired

Chain identifier such as ethereum, bsc or solana; pairs with address

addressstringqueryExample0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48required

Token contract address on chain_id

Query options

basic returns the core security summary. full also requests risk lists, tax_analysis and data_analysis. Missing fields are not a clean-risk guarantee

scopestringqueryExamplebasicoptional

Response depth. · basic / full · Default: basic

langstringqueryExampleenoptional

Language for token-security descriptions. · en / zh / cn / tw / ja / kr · Default: en

Response

request_idstring

Request trace identifier

generated_atdatetime

Response generation time, not the observation time

data_statusDataStatus

Business status: verified/ok, partial, no_data or not_ready. HTTP 200 alone does not establish coverage

empty_reasonunknown | null

Reason for an empty or unavailable result; may be absent

dataobject

Business data; shape is specific to this endpoint

addressstring

Token contract address

buy_taxstring

Buy tax rate

chain_idstring

Chain identifier

checked_atunknown | null

checked_at

concentration_unitstring

concentration_unit

holder_countstring

Holder count

is_honeypotboolean

Honeypot flag

is_open_sourceunknown | null

Open-source contract flag

name_riskobject

name_risk

is_domain_tokenboolean

is_domain_token

is_sensitiveboolean

is_sensitive

sensitive_wordsunknown | null

sensitive_words

risk_facts[]string[]

risk_facts

risk_summaryobject

Risk summary

high_risk_numnumber

High-risk count

highest_risk_levelnumber

Highest risk level

low_risk_numnumber

Low-risk count

middle_risk_numnumber

Medium-risk count

unknown_numnumber

Unknown risk count

scopestring

Detail scope

sell_taxstring

Sell tax rate

sourcestring

source

tax_unitstring

Tax unit

top10_percentstring

top10_percent

metadataobject

Response metadata

object_refs[]object[]

object_refs

idstring

id

chain_idstring

Chain identifier

contract_addressstring

contract_address

asset_entity_idunknown | null

asset_entity_id

asset_idunknown | null

Asset identifier

listing_idunknown | null

listing_id

instrument_idunknown | null

instrument_id

venue_idunknown | null

venue_id

symbolunknown | null

Asset symbol

quote_currencyunknown | null

quote_currency

requested_as_ofunknown | null

requested_as_of

resolved_as_ofunknown | null

resolved_as_of

next_cursorunknown | null

next_cursor

has_moreboolean

Whether more records are available

unresolved_object_refs[]unknown[]

unresolved_object_refs

errorunknown | null

Null on success; otherwise an error string or object

Errors & fallback

200
The requested data is returned.
200
Inspect data_status, empty_reason and data; individual fields may be null.
400
Check chain_id, address, scope and lang.
401
Check the API key.
403
Check Risk permission for the key.