{"definitionRoot":"c5be056e2bb83e0cc08bf08f9038da0374e3b17b3e3c69d9b52ce23760fe1b1f","docsPath":"/docs/SWAP_CALLDATA.json","errors":[{"code":null,"description":"The request field is invalid.","status":400},{"code":null,"description":"Payment Required - an x402 v2 offer in the PAYMENT-REQUIRED header and body.","status":402},{"code":null,"description":"The result could not be delivered.","status":422},{"code":null,"description":"The seller or the product quote path is not currently admitting this request.","status":503}],"examples":{"deliverable":null,"detail":"Concrete request/deliverable examples are omitted until real settled evidence supplies them; the no-fake-demand rule forbids inventing sample payloads. The envelope shapes above are exact.","request":null,"state":"OMITTED_UNTIL_REAL_EVIDENCE"},"family":"EXECUTION","familyTitle":"Arbiter Execution","freshness":{"evidenceCutoff":"Every delivered envelope states its own evidenceCutoff; requests may pin evidenceCutoff at or before quote time.","freshnessClass":"CURRENT_SNAPSHOT","latencyClass":"FAST","machineVersion":"df8b5c0c","outputDomainKind":null,"provenance":"The deliverable carries its own uncertainty statement; citations are opaque content hashes for the public evidence used."},"inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"amountIn":{"description":"Exact input in whole token units as a decimal string, e.g. \"250\" or \"0.5\".","type":"string"},"chainIds":{"description":"1 to 3 EVM chain ids to route on (any chain in Arbiter's venue book: Ethereum 1, Optimism 10, BNB 56, Polygon 137, Monad 143, zkSync 324, MegaETH 4326, Robinhood 4663, Arc 5042, Base 8453, Arbitrum 42161, Avalanche 43114, Linea 59144). Routing picks the best net outcome across them.","items":{},"type":"array"},"deadlineSeconds":{"description":"Optional 60-900 (default 300): the swap reverts on-chain after this many seconds.","type":"integer"},"maxPriceImpactBps":{"description":"Optional 1-1000 (default 100): routes whose price impact at your size is above this are refused.","type":"integer"},"slippageBps":{"description":"Optional 10-300: your slippage bound. Default: twice the measured price impact, at least 10 bps, at most the liquidity tier's cap (A 30, B 75, C 150).","type":"integer"},"taker":{"description":"Required: the wallet that will sign and send the transactions (Arbiter never signs, submits or holds funds).","type":"string"},"tokenIn":{"description":"What you sell: USD (the chain's issuer dollar), USDC, WRAPPED_NATIVE, WETH, or a 0x token address (then name exactly one chain).","type":"string"},"tokenOut":{"description":"What you buy: same forms as tokenIn.","type":"string"}},"required":["chainIds","tokenIn","tokenOut","amountIn","taker"],"type":"object","x-arbiter-contentType":"application/json","x-arbiter-schemaVersion":"1.0.0"},"method":"POST","operationId":"agenthubmachineswap_calldata","outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"best":{"description":"The best route (or null): chain, venue, pool, pool fee, amounts in base units and decimals, expected and minimum output (net of any integrator fee), slippage bound, price impact, liquidity tier, gas (units, gas price, native cost and - where priceable - cost in the output token), the quoter simulation and block, and mempool advice.","type":"object"},"chains":{"description":"Per chain: QUOTED or SKIPPED, the pinned block, how many keyed operators agreed, and why a chain was skipped.","items":{},"type":"array"},"custody":{"description":"Always NON_CUSTODIAL: you sign and send; Arbiter never holds keys or funds.","type":"string"},"deadlineUnix":{"description":"Unix time after which the swap reverts on-chain.","type":"integer"},"evaluatedAt":{"description":"ISO-8601 instant the quote was taken (the chains' pinned blocks are in `chains`).","type":"string"},"feeLegGuard":{"description":"{passed: true, feeBps}: the built swap was decoded and proven to pay only the disclosed fee, in an eligible token, to the revenue vault (0 when no fee).","type":"object"},"integratorFee":{"description":"Whether an integrator fee is on, its bps per leg kind, caps and recipient; off by default.","type":"object"},"program":{"description":"Program identity: {id, version, programRoot, registryRoot, policyRoot}.","type":"object"},"provenance":{"description":"Deliverable provenance: {basis, thirdPartyData: false, networkAccess: true, aggregatorApis: false, inputRoot, programRoot, policyRoot, quotePlanRoot, observationRoot, outputRoot}.","type":"object"},"rankingBasis":{"description":"NET_OF_FEE_AND_GAS, or NET_OF_FEE_GAS_REPORTED_SEPARATELY when gas cannot be priced in the output token.","type":"string"},"refused":{"description":"Every route refused, with its reason (price impact above your limit, outlier versus the median, nothing out).","items":{},"type":"array"},"request":{"description":"Your request as Arbiter read it: chainIds, tokenIn, tokenOut, amountIn, taker.","type":"object"},"route":{"description":"The route the transactions execute (the best route the taker can fund).","type":"object"},"routes":{"description":"Every route that passed, best first, in the same shape as best.","items":{},"type":"array"},"screening":{"description":"The pre-payment screen: OFAC SDN snapshot time and root, and each token's verdict (PINNED, PASS, UNSCREENED).","type":"object"},"simulation":{"description":"debug_traceCall from the taker on both keyed operators at the pinned block: swap SUCCEEDED, REVERTED, OPERATORS_DISAGREE, UNAVAILABLE, NOT_RUN_REQUIRES_APPROVAL or NOT_RUN_INSUFFICIENT_BALANCE; and the first approval's result.","type":"object"},"timing":{"description":"Engine wall time in milliseconds and the declared completion budget (p95 and maximum seconds).","type":"object"},"transactions":{"description":"Unsigned transactions in order: {step APPROVE_RESET|APPROVE|SWAP, chainId, from, to, data, value, gas, description}. Your wallet sets nonce and fee fields, signs and sends.","items":{},"type":"array"},"uncertainty":{"description":"Plain-language limits of this quote.","type":"string"},"warnings":{"description":"Fixed codes: INSUFFICIENT_INPUT_BALANCE, INSUFFICIENT_NATIVE_FOR_GAS, SWAP_REVERTS_AT_QUOTED_BLOCK.","items":{},"type":"array"}},"required":["request","best","routes","refused","chains","rankingBasis","screening","integratorFee","timing","route","transactions","simulation","deadlineUnix","warnings","custody","feeLegGuard","evaluatedAt","program","provenance","uncertainty"],"type":"object","x-arbiter-contentType":"application/json","x-arbiter-schemaVersion":"1.0.0"},"payment":{"admitted":true,"challengeHeader":"PAYMENT-REQUIRED","destination":{"address":"0x63aA5960943865e7d57FDdF0D899eE36B6D2046E","assetContracts":["0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85","0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392","0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359","0x754704Bc059F8C67012fEd69BC8A327a5aafb603","0xaf88d065e77c8cC2239327C5EDb3A432268e5831","0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E","0x3600000000000000000000000000000000000000","0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"],"bindingVersion":"a2f250e514c4a05c34efc98c49a4f4ac01a67770884883d19ff3a6487972ed90","networks":["eip155:1","eip155:10","eip155:1329","eip155:137","eip155:143","eip155:42161","eip155:43114","eip155:5042","eip155:8453"],"resolvable":true,"source":"x402_seller_configuration.payTo"},"logicalPaymentHeader":"ARBITER-LOGICAL-PAYMENT-ID","payToSource":"the canonical RevenueWalletResolver binding (x402_seller_configuration.payTo); never an environment value and never a literal","paymentIdentifier":{"extension":"payment-identifier","semantics":"Retries carrying the same payment identifier return the cached delivery with the same receipt: no second settlement, no second work, no second delivery credit.","supported":true},"processingSemantics":"A 202 means verification or settlement is still in progress; retry the same call with the same payment and the same payment identifier.","protocol":"X402_V2","protocolVersion":2,"quoteHeader":"ARBITER-QUOTE-ID","scheme":"exact","signatureHeader":"PAYMENT-SIGNATURE"},"pricing":{"currency":"USD","floorUsd":0.00858,"mode":"DYNAMIC_QUOTE","ownerCeilingUsd":null,"pricingClass":"CURRENT_UNIT","publicStartingPriceUsd":0.00858},"productId":"SWAP_CALLDATA","productVersion":"1.0.0","provenance":{"basis":"SWAP_VENUES","protocols":["Arbiter's pinned venue book (Uniswap V3 fee tiers, Uniswap V2 and PancakeSwap V2)"],"sources":["Public EVM chain state, read at a confirmed block by two independent keyed RPC operators (Alchemy, dRPC) that must agree"]},"resourceUrl":"https://arbiterverse.com/api/x402/SWAP_CALLDATA","schemaVersion":"1.0.0","summary":"Everything SWAP_QUOTE returns, plus the unsigned transactions your own wallet signs and sends for the best route you can fund: an exact-amount approval when needed (never unlimited), then the swap with a hard minimum output and an on-chain deadline, simulated from your wallet on two RPC operators at the pinned block. Arbiter never signs, submits or holds funds. Optional integrator fee: off unless enabled; then at most 10 bps on stablecoin and 25 bps on WETH output legs, paid inside your transaction and proven by a fee-leg guard. Unscreened tokens are refused. Example request: {\"chainIds\":[8453],\"tokenIn\":\"USDC\",\"tokenOut\":\"WETH\",\"amountIn\":\"250\",\"taker\":\"0xYourWallet\"}. Declared completion: p95 3 s, max 15 s.","title":"Swap calldata: unsigned transactions for your wallet to sign"}