WALLET VERIFY API · V1

Risk intelligence as an API

The same 14-layer Risk Intelligence Engine and forensic modules behind this site, callable from your stack. Screen any address on Ethereum, EVM chains, Bitcoin, Tron, and Solana; trace funds, resolve clusters, and verify signed reports. Versioned response contract — additive changes only.

AUTHENTICATION

Every request carries your API key in either header form. Keys are issued per organization — see pricing for plans with API access.

Authorization: Bearer wv_your_key_here
# or
X-API-Key: wv_your_key_here

QUICK START

curl -s -X POST https://verify.blox.global/api/v1/screen \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WV_API_KEY" \
  -d '{"address": "0x…", "chainId": "1"}'

The response includes the verdict, 0–100 risk score, per-layer factors, balances, wallet age, activity, classification flags, and a screening-provenance block. A verdict of analyzing means screening has not completed — treat it as not-yet-graded, never as a pass.

ENDPOINTS

POST/api/v1/screenAll tiers

Full wallet screening: verdict, risk score, layer breakdown, balances, wallet age, activity, flags, on-chain blacklist, screening provenance.

GET/api/v1/tokens/{chain}/{address}Paid

Token holdings detail for a wallet.

POST/api/v1/tokens/tracePaid

Provenance of each held token — first-receive tx, originating wallet, distance from deployment.

POST/api/v1/path-traceForensic+

Shortest fund-flow path between two wallets with per-hop volumes and timing.

GET/api/v1/clusters/{chain}/{address}Forensic+

Common-control cluster containing the address: members, confidence, signals.

POST/api/v1/time-machineForensic+

Reconstructed wallet state (balances, nonce) at a historical block.

POST/api/v1/cross-chain-linkForensic+

Candidate sister-addresses across chains from bridge and CEX-deposit correlation.

GET/api/v1/honeypot/{chain}/{token}Forensic+

Buy/sell simulation verdict for a token contract.

POST/api/v1/graphqlForensic+

GraphQL access to screening and all forensic modules. GET returns the schema SDL.

POST/api/v1/verify-reportPublic

Verify the Ed25519 signature of a downloaded report — no key required.

GET/api/v1/openapi.jsonPublic

OpenAPI 3.0 spec — point your SDK generator here.

SPEC & TOOLING

The full request/response contract lives in the OpenAPI 3.0 spec — generate typed clients with any OpenAPI toolchain. Rate limits and monthly quotas are returned on every response (meta.quotaRemaining, X-Quota-Remaining). Downloaded reports are Ed25519-signed; anyone can verify one at POST /api/v1/verify-report without a key.