x402 · pay-per-request compliance API

x402 Compliance API for AI Agent Wallet Screening

Query address labels and screen wallet risk through x402. Pay per request in USDC on Base, with no API key or subscription.

Official example · excerptDemo only
View full example and wallet setup

Per-request pricing, paid in USDC

USDC on Base · per request · no subscription

Label Query

$0.10/ request

Address labels and entity attribution from BlockSec / MetaSleuth intelligence.

GET/label/{chain}/{address}

Light Screening

$0.20/ request

A fast risk score for address triage, routing, and lightweight pre-checks.

GET/screen/light/{chain}/{address}

Deep Screening

$1.00/ request

A full KYA report with deeper exposure analysis and compliance context.

GET/screen/deep/{chain}/{address}

Deep Screening response documentation requires a Phalcon Compliance account.

Connect your agent

Browse the free service catalog. Address queries and screening are paid.

View agent example
  1. Explore the services

    Check endpoints, prices, and supported chains in the free catalog.

  2. Prepare your wallet

    Fund it with USDC on Base and set a spending limit for each request.

  3. Use the agent example

    Open the API site and expand “Autonomous agent example” for the x402-fetch demo.

Service discovery

Free request · No wallet needed
GEThttps://x402.blocksec.ai/.well-known/x402.json
Open the free catalog

Documentation

API calls need no account. Deep Screening response docs require Phalcon Compliance signup.

How x402 payment works

1

Request without a key

Call a paid endpoint directly. There is no API key and no account — the server responds with an HTTP 402 Payment Required quote for that request.

2

Pay per request in USDC

Your agent signs a gasless EIP-3009 authorization and retries with an X-PAYMENT header — a USDC micropayment on Base for exactly that one call.

3

Get JSON back

Once payment is verified, the endpoint returns the labels or risk report as JSON. A free discovery endpoint lists every endpoint and its price up front.

What you can screen

Address Labels

MetaSleuth

Entity labels and categories for exchanges, protocols, contracts, and known wallets.

Light Screening

Risk screening

A fast risk score for address triage, routing, and lightweight pre-checks.

Deep Screening

Phalcon Compliance

A full KYA report with deeper exposure analysis and compliance context.

Coverage

Address screening across 9 chains

Screen addresses across 9 networks — Ethereum, Bitcoin, Tron, and the major EVM L2s — through the same service endpoints using a chain parameter.

BlockSec
Ethereum
Tron
BNB Chain
Base
Polygon
Arbitrum
Optimism
Avalanche
Bitcoin

Agent-native compliance, explained

Choose your screening depth

Label Query returns address labels and entity information. Light Screening returns a fast risk score. Deep Screening provides a full KYA report with deeper exposure analysis and compliance context.

The x402 endpoints provide address labels and risk screening. Review each service’s response documentation for its available fields.

Why per-request payments fit AI agents

x402 removes account provisioning and API-key management from the integration. An agent can pay for the checks it needs with a signed USDC micropayment.

See Build KYA/KYT with x402 for the full walkthrough.

Built for autonomous workflows

Submit paid requests directly from agents, backends, or scripts using x402-fetch or viem — no human in the loop.

The same rails power the Web3 Companion agentic wallet.

Frequently Asked Questions

Start screening from your agent today

Run KYA address screening directly from your agents, backends, or scripts — pay per request in USDC, with no API key and no account.