Address Labels API
Resolve entity labels and categories for exchanges, protocols, contracts, and known wallets.
GET /label/{chain}/{address}/label/ethereum/0x463452c356322d463b84891ebda33daed274cb40Query BlockSec address labels and Phalcon Compliance risk screening through simple paid API endpoints. Each request is priced in USDC through the x402 protocol.
Select a service, chain, and address.
Endpoints return JSON after a valid x402 payment.
Resolve entity labels and categories for exchanges, protocols, contracts, and known wallets.
GET /label/{chain}/{address}/label/ethereum/0x463452c356322d463b84891ebda33daed274cb40Return a fast risk score for address triage, routing, and lightweight pre-checks.
GET /screen/light/{chain}/{address}/screen/light/tron/TYXqLb9ZyAeJeTFkt3Tx7kNyc3HufjvnMsReturn a full KYA report with deeper exposure analysis and compliance context.
GET /screen/deep/{chain}/{address}/screen/deep/tron/TYXqLb9ZyAeJeTFkt3Tx7kNyc3HufjvnMsHow to reference each chain in the /label/{chain}/{address} path, e.g. /label/ethereum/0x….
| Chain | {chain} value | chain_id |
|---|---|---|
| Ethereum | ethereum | 1 |
| Tron | tron | -2 |
| BNB Chain | bnb | 56 |
| Base | base | 8453 |
| Polygon | polygon | 137 |
| Arbitrum | arbitrum | 42161 |
| Optimism | optimism | 10 |
| Avalanche | avalanche | 43114 |
| Bitcoin | bitcoin | -1 |
Abbreviations also accepted for compatibility: eth, bsc, matic, avax, btc. Matching is case-insensitive.
Every endpoint is gated by the x402 payment protocol — pay per request in USDC on Base. No API key, no account.
GET /.well-known/x402.json lists every endpoint and its price (free, no payment)./label/{chain}/{address} returns HTTP 402 with the USDC-on-Base payment requirements.X-PAYMENT header — the response is your JSON result.import { createWalletClient, http } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { base } from "viem/chains";
import { wrapFetchWithPayment } from "x402-fetch";
// Agent wallet, funded with USDC on Base
const account = privateKeyToAccount(process.env.AGENT_PRIVATE_KEY as `0x${string}`);
const wallet = createWalletClient({ account, chain: base, transport: http() });
// Wrap fetch: auto-handles 402 -> signs a gasless EIP-3009
// authorization -> retries with the payment header.
// 3rd arg caps spend per call (USDC base units): 1_000000n = $1.00,
// enough for deep screening (default is only 0.1 USDC).
const fetchWithPay = wrapFetchWithPayment(fetch, wallet, 1_000000n);
const res = await fetchWithPay(
"https://x402.blocksec.ai/label/ethereum/0x463452c356322d463b84891ebda33daed274cb40",
);
console.log(await res.json());Browser: open any endpoint URL directly and pay through the built-in wallet paywall.
Reference: BlockSec's open-source web3-companion agentic wallet uses exactly this flow.