代币合约安全

查询代币合约安全信息、交易税和风险汇总。

GET/api/v1/risk/token-security
数据域
风险与合规
解析层级
每次查询一条链上的一个代币合约
MCP 工具
risk_compliance_query (task=token_security)

可查询数据

返回数据
查询代币合约安全信息、交易税和风险汇总。
每次返回什么
每次查询一条链上的一个代币合约

认证

所有请求需携带 Authorization: Bearer YOUR_API_KEY 或 X-API-KEY。

需要具备 Risk 权限的 API Key。

请求参数

查询示例
合约定位

chain_id与address均必填;使用合约地址,不使用代币代码

chain_idstringquery示例ethereum必填

链标识,例如 ethereum、bsc、solana;与 address 一起指定代币合约

addressstringquery示例0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48必填

该链上的代币合约地址

查询选项

basic返回核心安全摘要;full另返回风险列表、tax_analysis和data_analysis等扩展项。字段缺失不代表没有风险

scopestringquery示例basic可选

安全检查详略程度。 · basic / full · 默认: basic

langstringquery示例en可选

安全描述的语言。 · en / zh / cn / tw / ja / kr · 默认: en

响应

request_idstring

请求追踪标识

generated_atdatetime

响应生成时刻,不是数据观测时刻

data_statusDataStatus

ok / partial / no_data / upstream_error / not_ready;HTTP 200 不代表数据覆盖完整

empty_reasonunknown | null

成功时为 null;空结果读取 not_covered 或 object_unresolved 等原因

dataobject

本 task 的业务数据;Token Security 为对象,其他查询通过 items 返回

addressstring

代币合约地址

buy_taxstring

买入税率

chain_idstring

链标识

checked_atunknown | null

checked_at

concentration_unitstring

concentration_unit

holder_countstring

持有人数

is_honeypotboolean

蜜罐检测结果

is_open_sourceunknown | null

合约开源状态

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

风险汇总

high_risk_numnumber

高风险项数

highest_risk_levelnumber

最高风险等级

low_risk_numnumber

低风险项数

middle_risk_numnumber

中风险项数

unknown_numnumber

未知风险项数

scopestring

详情范围

sell_taxstring

卖出税率

sourcestring

source

tax_unitstring

税率单位

top10_percentstring

top10_percent

metadataobject

对象解析、分页和实际观测时点

object_refs[]object[]

object_refs

idstring

对象标识,标识 type 指定的具体对象

chain_idstring

链标识

contract_addressstring

contract_address

asset_entity_idunknown | null

asset_entity_id

asset_idunknown | null

资产标识,标识股票、加密资产等资产对象

listing_idunknown | null

交易场所挂牌标识,标识某个交易品种在特定交易场所的挂牌记录

instrument_idunknown | null

交易工具标识,标识股票、现货交易对或合约等具体交易产品

venue_idunknown | null

交易场所标识,标识交易所或交易平台

symbolunknown | null

资产代码

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

是否还有更多记录

unresolved_object_refs[]unknown[]

unresolved_object_refs

errorunknown | null

成功时为 null;参数或上游错误为结构化对象

错误与降级

200
返回所查数据。
200
检查 data_status、empty_reason 和 data;字段可能为 null。
400
核对 chain_id、address、scope 和 lang。
401
检查 API Key。
403
检查 Key 的 Risk 权限。