Skip to main content
POST
Agent Check

Authorizations

X-API-Key
string
header
required

Body

application/json

An EVM wallet, and optionally the ERC-8004 agent id it claims.

wallet
string
required

EVM wallet address (0x + 40 hex characters). Read on Base.

Example:

"0x4b4b4b4b4b4b4b4b4b4b4b4b4b4b4b4b4b4b4b4b"

agent_id
string | null

Optional ERC-8004 agentId (decimal) the wallet claims. When given, the check reads that agent's owner and payment wallet and says whether this wallet is one of them.

Example:

"1"

domain
string | null

Optional website domain the agent gives for itself (e.g. example.com). Reported with WHOIS age, mail records and TLS certificate; never read by the verdict.

Maximum string length: 253
Example:

"example.com"

Response

Successful Response

The bundle: one verdict, and each component with its own status.

wallet
string
required
chain_id
string
required
verdict
enum<string>
required
Available options:
block,
review,
no_findings
verdict_reasons
string[]
required
ran
string[]
required
did_not_run
SkippedComponent · object[]
required
sanctions
SanctionsComponent · object
required

OFAC SDN digital-currency address list match for the wallet.

balance
BalanceComponent · object
required

USDC and native (ETH) balance of the wallet on the deployed Base chain.

identity
IdentityComponent · object
required

ERC-8004 identity registration of the wallet, and of the given agent id.

reputation
ReputationComponent · object
required

Open ERC-8004 feedback. Reported only; never read by the verdict.

wallet_risk
WalletRiskComponent · object
required

The wallet screen's own risk score and the named rules that fired.

domain
DomainComponent · object
required

WHOIS (RDAP) age, DNS mail records and TLS certificate of the domain the caller gave.

Reported only; never read by the verdict. A field whose probe got no answer is None, never False.

checked_at
string
required
schema_version
string
default:agent-check-v1
Allowed value: "agent-check-v1"