{"schema_version":"1.0.0","service":"Orcpin","description":"Agent-native x402 API returning factual, block-anchored on-chain wallet and DeFi position snapshots on Base.","base_url":"https://orcpin.dev","payment":{"protocol":"x402","version":2,"currency":"USDC","network":"eip155:84532","testnet":true,"unpaid_dev_mode":false},"disclaimer":"Responses are informational on-chain snapshots only. Not financial advice. See /terms.","endpoints":[{"name":"health","method":"GET","path":"/health","payment_required":false},{"name":"service_catalog","method":"GET","path":"/catalog","aliases":["/"],"payment_required":false},{"name":"terms","method":"GET","path":"/terms","payment_required":false},{"name":"wallet_snapshot","method":"GET","path":"/v1/wallet-snapshot","payment_required":true,"x402":{"scheme":"exact","price":"$0.02","network":"eip155:84532","pay_to":"0x8B1CF12e7efe6AEA59cD1124eBbe7709E3Ac6085"},"parameters":[{"name":"address","in":"query","required":true,"description":"EVM wallet address to snapshot (0x...).","schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"}}],"response":{"schema_version":"1.0.0","as_of":"block","fields":["address","block_number","data.account.is_contract","data.account.transaction_count","data.native_balance","data.token_balances","sources","disclaimer"]},"example":"https://orcpin.dev/v1/wallet-snapshot?address=0x0000000000000000000000000000000000000001"},{"name":"defi_snapshot","method":"GET","path":"/v1/defi-snapshot","payment_required":true,"description":"Premium snapshot: balances + account flags + Aave v3 collateral, debt, and health factor — all read directly from chain/protocol.","x402":{"scheme":"exact","price":"$0.05","network":"eip155:84532","pay_to":"0x8B1CF12e7efe6AEA59cD1124eBbe7709E3Ac6085"},"parameters":[{"name":"address","in":"query","required":true,"description":"EVM wallet address to snapshot (0x...).","schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"}}],"response":{"schema_version":"1.0.0","as_of":"block","fields":["address","block_number","data.account","data.native_balance","data.token_balances","data.aave_v3.total_collateral","data.aave_v3.total_debt","data.aave_v3.health_factor","data.aave_v3.no_outstanding_debt","sources","disclaimer"]},"example":"https://orcpin.dev/v1/defi-snapshot?address=0x0000000000000000000000000000000000000001"},{"name":"batch_snapshot","method":"GET","path":"/v1/batch-snapshot","payment_required":true,"description":"Wallet snapshots for up to 10 addresses in one paid call, all anchored to a single block. One bad address returns a per-item error without failing the batch.","x402":{"scheme":"exact","price":"$0.10","network":"eip155:84532","pay_to":"0x8B1CF12e7efe6AEA59cD1124eBbe7709E3Ac6085"},"limits":{"max_addresses":10},"parameters":[{"name":"addresses","in":"query","required":true,"description":"Comma-separated EVM addresses (0x...), max per batch config.","schema":{"type":"string"}}],"response":{"schema_version":"1.0.0","as_of":"block","fields":["block_number","count","results[].address","results[].data","results[].error","sources","disclaimer"]},"example":"https://orcpin.dev/v1/batch-snapshot?addresses=0x0000000000000000000000000000000000000001,0x0000000000000000000000000000000000000002"}],"agent_integration":{"caller_library":"@x402/fetch","flow":["GET endpoint without payment header","Receive HTTP 402 with x402 payment requirements","Sign and send USDC payment on configured network","Retry GET with x402 payment header","Receive JSON snapshot"],"test_script":"npm run test:agent"}}