Token security
Check token contract security, trading taxes and risk-summary fields.
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
Requires an API key with Risk permission.
Query Parameters
Both chain_id and address are required. Use a contract address, not a ticker
chain_idstringqueryExampleethereumrequiredChain identifier such as ethereum, bsc or solana; pairs with address
addressstringqueryExample0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48requiredToken contract address on chain_id
basic returns the core security summary. full also requests risk lists, tax_analysis and data_analysis. Missing fields are not a clean-risk guarantee
scopestringqueryExamplebasicoptionalResponse depth. · basic / full · Default: basic
langstringqueryExampleenoptionalLanguage for token-security descriptions. · en / zh / cn / tw / ja / kr · Default: en
Response
request_idstringRequest trace identifier
generated_atdatetimeResponse generation time, not the observation time
data_statusDataStatusBusiness status: verified/ok, partial, no_data or not_ready. HTTP 200 alone does not establish coverage
empty_reasonunknown | nullReason for an empty or unavailable result; may be absent
Business data; shape is specific to this endpoint
addressstringToken contract address
buy_taxstringBuy tax rate
chain_idstringChain identifier
checked_atunknown | nullchecked_at
concentration_unitstringconcentration_unit
holder_countstringHolder count
is_honeypotbooleanHoneypot flag
is_open_sourceunknown | nullOpen-source contract flag
name_risk
is_domain_tokenbooleanis_domain_token
is_sensitivebooleanis_sensitive
sensitive_wordsunknown | nullsensitive_words
risk_facts[]string[]risk_facts
Risk summary
high_risk_numnumberHigh-risk count
highest_risk_levelnumberHighest risk level
low_risk_numnumberLow-risk count
middle_risk_numnumberMedium-risk count
unknown_numnumberUnknown risk count
scopestringDetail scope
sell_taxstringSell tax rate
sourcestringsource
tax_unitstringTax unit
top10_percentstringtop10_percent
Response metadata
object_refs
typeObjectRefTypetype
idstringid
chain_idstringChain identifier
contract_addressstringcontract_address
asset_entity_idunknown | nullasset_entity_id
asset_idunknown | nullAsset identifier
listing_idunknown | nulllisting_id
instrument_idunknown | nullinstrument_id
venue_idunknown | nullvenue_id
symbolunknown | nullAsset symbol
quote_currencyunknown | nullquote_currency
requested_as_ofunknown | nullrequested_as_of
resolved_as_ofunknown | nullresolved_as_of
next_cursorunknown | nullnext_cursor
has_morebooleanWhether more records are available
unresolved_object_refs[]unknown[]unresolved_object_refs
errorunknown | nullNull on success; otherwise an error string or object