{"version":1,"service":"MACH Base","canonical_origin":"https://api.mach.gallery","decision_layer":"https://api.mach.gallery/api/choose","note":"Examples describe the paid request and response shape only; they do not include live paid Base data.","jobs":[{"version":1,"kind":"mach_decision","decision_layer":"/api/choose","free":true,"network":"eip155:8453","asset":"USDC","no_live_chain_data":true,"semantics":{"read_only":true,"side_effects":"none","freshness":"The paid capability reads Base mainnet at request time; this preview is not live chain data.","retry_safety":"Read-only. Retry only when no payment was accepted; every accepted paid call is independently billable.","invalid_input":"Malformed paid inputs return HTTP 422 before the x402 payment challenge."},"goal":"verify whether this Base payment settled and get confirmations","recommended_capability":"base_transaction_context","why":"It combines transaction, receipt, success, confirmations, gas and fee evidence in one read-only answer, which is the shortest path for payment settlement checks and failed-transaction debugging.","exact_price":{"usd":"$0.008","usdc_atomic":"8000","network":"eip155:8453","asset":"USDC"},"expected_result_fields":["found","state","success","confirmations","from","to","gas_used","fee_wei"],"cheaper_compound_alternative":null,"exact_next_paid_call":{"http":{"method":"POST","path":"/api/base/transaction-context","body":{"tx_hash":"0x0000000000000000000000000000000000000000000000000000000000000000"}},"mcp":{"tool":"base_transaction_context","arguments":{"tx_hash":"0x0000000000000000000000000000000000000000000000000000000000000000"}}}},{"version":1,"kind":"mach_decision","decision_layer":"/api/choose","free":true,"network":"eip155:8453","asset":"USDC","no_live_chain_data":true,"semantics":{"read_only":true,"side_effects":"none","freshness":"The paid capability reads Base mainnet at request time; this preview is not live chain data.","retry_safety":"Read-only. Retry only when no payment was accepted; every accepted paid call is independently billable.","invalid_input":"Malformed paid inputs return HTTP 422 before the x402 payment challenge."},"goal":"why did this Base transaction fail","recommended_capability":null,"why":"No single MACH capability is a safe exact match for that goal. Refine the question with the Base object or result you need; this free preview never returns paid chain data.","exact_price":null,"expected_result_fields":[],"cheaper_compound_alternative":null,"exact_next_paid_call":null,"supported_capabilities":["base_transaction_context","base_receipt","base_transaction","base_wallet_snapshot","base_contract_info","base_erc20_transfers","base_contract_code","base_eth_call","base_total_supply","base_logs","base_block","base_block_number","base_gas_price","base_wallet_balance","base_erc20_balance","base_nonce","base_allowance"]},{"version":1,"kind":"mach_decision","decision_layer":"/api/choose","free":true,"network":"eip155:8453","asset":"USDC","no_live_chain_data":true,"semantics":{"read_only":true,"side_effects":"none","freshness":"The paid capability reads Base mainnet at request time; this preview is not live chain data.","retry_safety":"Read-only. Retry only when no payment was accepted; every accepted paid call is independently billable.","invalid_input":"Malformed paid inputs return HTTP 422 before the x402 payment challenge."},"goal":"can this wallet make the intended payment","recommended_capability":"base_wallet_snapshot","why":"It returns native ETH plus the requested ERC-20 balances in one read-only wallet snapshot, minimizing separate balance calls for an audit or pre-payment check.","exact_price":{"usd":"$0.005","usdc_atomic":"5000","network":"eip155:8453","asset":"USDC"},"expected_result_fields":["address","native_wei","tokens[].token","tokens[].balance_atomic"],"cheaper_compound_alternative":{"capability":"base_wallet_balance","price_usd":"$0.005","why":"If only native ETH is needed, the narrower wallet-balance call is the same low price and avoids supplying token contracts."},"exact_next_paid_call":{"http":{"method":"POST","path":"/api/base/wallet-snapshot","body":{"address":"0x0000000000000000000000000000000000000001","tokens":["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"]}},"mcp":{"tool":"base_wallet_snapshot","arguments":{"address":"0x0000000000000000000000000000000000000001","tokens":["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"]}}}},{"version":1,"kind":"mach_decision","decision_layer":"/api/choose","free":true,"network":"eip155:8453","asset":"USDC","no_live_chain_data":true,"semantics":{"read_only":true,"side_effects":"none","freshness":"The paid capability reads Base mainnet at request time; this preview is not live chain data.","retry_safety":"Read-only. Retry only when no payment was accepted; every accepted paid call is independently billable.","invalid_input":"Malformed paid inputs return HTTP 422 before the x402 payment challenge."},"goal":"what contract or token is this","recommended_capability":"base_contract_info","why":"It answers what a Base contract is and what token it represents with metadata, bytecode size, supply and common interface signals in one read-only call.","exact_price":{"usd":"$0.005","usdc_atomic":"5000","network":"eip155:8453","asset":"USDC"},"expected_result_fields":["is_contract","bytecode_bytes","name","symbol","decimals","total_supply_atomic","is_erc721","is_erc1155"],"cheaper_compound_alternative":null,"exact_next_paid_call":{"http":{"method":"POST","path":"/api/base/contract-info","body":{"address":"0x0000000000000000000000000000000000000001"}},"mcp":{"tool":"base_contract_info","arguments":{"address":"0x0000000000000000000000000000000000000001"}}}},{"version":1,"kind":"mach_decision","decision_layer":"/api/choose","free":true,"network":"eip155:8453","asset":"USDC","no_live_chain_data":true,"semantics":{"read_only":true,"side_effects":"none","freshness":"The paid capability reads Base mainnet at request time; this preview is not live chain data.","retry_safety":"Read-only. Retry only when no payment was accepted; every accepted paid call is independently billable.","invalid_input":"Malformed paid inputs return HTTP 422 before the x402 payment challenge."},"goal":"show wallet state","recommended_capability":"base_wallet_snapshot","why":"It returns native ETH plus the requested ERC-20 balances in one read-only wallet snapshot, minimizing separate balance calls for an audit or pre-payment check.","exact_price":{"usd":"$0.005","usdc_atomic":"5000","network":"eip155:8453","asset":"USDC"},"expected_result_fields":["address","native_wei","tokens[].token","tokens[].balance_atomic"],"cheaper_compound_alternative":{"capability":"base_wallet_balance","price_usd":"$0.005","why":"If only native ETH is needed, the narrower wallet-balance call is the same low price and avoids supplying token contracts."},"exact_next_paid_call":{"http":{"method":"POST","path":"/api/base/wallet-snapshot","body":{"address":"0x0000000000000000000000000000000000000001","tokens":["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"]}},"mcp":{"tool":"base_wallet_snapshot","arguments":{"address":"0x0000000000000000000000000000000000000001","tokens":["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"]}}}},{"version":1,"kind":"mach_decision","decision_layer":"/api/choose","free":true,"network":"eip155:8453","asset":"USDC","no_live_chain_data":true,"semantics":{"read_only":true,"side_effects":"none","freshness":"The paid capability reads Base mainnet at request time; this preview is not live chain data.","retry_safety":"Read-only. Retry only when no payment was accepted; every accepted paid call is independently billable.","invalid_input":"Malformed paid inputs return HTTP 422 before the x402 payment challenge."},"goal":"find recent token transfers for this wallet","recommended_capability":"base_erc20_transfers","why":"It finds recent ERC-20 transfer events and can filter them by token, sender or recipient wallet.","exact_price":{"usd":"$0.005","usdc_atomic":"5000","network":"eip155:8453","asset":"USDC"},"expected_result_fields":["token","from_block","to_block","count","truncated","transfers"],"cheaper_compound_alternative":null,"exact_next_paid_call":{"http":{"method":"POST","path":"/api/base/erc20-transfers","body":{"token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","from_address":"0x0000000000000000000000000000000000000001"}},"mcp":{"tool":"base_erc20_transfers","arguments":{"token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","from_address":"0x0000000000000000000000000000000000000001"}}}}],"payment_flow":["Make the exact request without a payment.","Read the x402 v2 PAYMENT-REQUIRED header and exact USDC amount.","Authorize and sign in the caller-owned wallet.","Retry once with PAYMENT-SIGNATURE.","Use PAYMENT-RESPONSE and the typed result; do not blindly repeat an ambiguous payment."],"errors":{"402":"Normal unpaid price-quote step; no payment has been accepted.","422":"Malformed input; rejected before the payment challenge.","429":"Back off and retry according to the response policy.","5xx":"Retry once only when no payment was accepted; treat an ambiguous signed request as a settlement investigation."},"preflight":"https://api.mach.gallery/api/preflight","trust":"https://api.mach.gallery/api/trust"}