Docs / Recipient readiness card

How do I check recipient readiness before my agent sends funds?

Meridian by MioDio's GET /v1/recipient/:address gives back a recipient readiness card for $0.005 USDC on Base via x402: Base vs Ethereum code, EIP-7702 vs a known-wallet allowlist (unknown if unlisted; never safe), USDC freeze on Base and Ethereum, USDT freeze on Ethereum only, OFAC exact match, burn/token flags, and optional lookalike checks. Informational, not advice.

Signals included

Paid 200 is a recipient_readiness card. Keys: product, card, version, status (ok or partial), address, chain, checked_chains, as_of, observed_at, disclaimer, code (this_chain, other_chain, undeployed_other_chain_trap), eip7702, freeze (USDC on Base and Ethereum; USDT on Ethereum only), sanctions (match, sdn_entries, list_version, list_updated_at, sources), known_address, poisoning (null unless counterparties/from are sent), optional errors.

Signals from that card:

Query parameters

Call it

curl -i "https://meridian.miodiollc.com/v1/recipient/0x0000000000000000000000000000000000000001?chain=base"

Unpaid -> HTTP 402 + PAYMENT-REQUIRED. Both-chain fail -> 503 and not settled. Partial 200 is possible when some reads succeed.

Price

$0.005 USDC on Base (~5000 atomic). Network eip155:8453. Asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913. payTo 0x4DA1ED782BD61BaE9AdD5a5CaBbCf32f767f8d7F.

Errors

What it does NOT do

Unpaid calls return HTTP 402 with PAYMENT-REQUIRED. Retry with PAYMENT-SIGNATURE.

FAQ

Does unknown wallet mean safe?
No. EIP-7702 vs known-wallet allowlist: unknown if unlisted; never safe.
Is this legal advice?
No. Informational, not advice.
What freeze coverage exists?
USDC freeze on Base and Ethereum. USDT freeze on Ethereum only.
How do lookalike checks work?
Optional. Requires counterparties and/or from query (caller-list lookalike only, max 20 unique).

Related