{"definitionRoot":"1acd06f29d7fe95c24eddcaf8477ac0efba0a17c0af7b5f72e69632aa0404f5b","docsPath":"/docs/ACTION_ECONOMICS_QUOTE.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":{"action":{"description":"SUPPLY, WITHDRAW, BORROW, REPAY, SWAP, VAULT_DEPOSIT or VAULT_WITHDRAW. BRIDGE is refused before payment: Arbiter prices no bridge route.","type":"string"},"amount":{"description":"The amount in whole token units as a decimal string (the asset, or for SWAP the token you sell), e.g. \"10000\" or \"2.5\".","type":"string"},"expectedHoldDays":{"description":"Optional 1-3650 (default 30): how long you hold, for expected yield, borrow cost and break-even.","type":"integer"},"market":{"description":"Lending only, optional: the Aave v3 Pool address where the chain has several; default the first pinned market that lists the asset.","type":"string"},"nativePriceInAsset":{"description":"Optional: your price of the chain's native coin in units of the asset (or the sold token), used only to express gas in it; not needed for the wrapped native token or a pool whose other leg is the wrapped native token.","type":"string"},"query":{"description":"The subject: the asset (the Aave reserve's underlying token) for SUPPLY, WITHDRAW, BORROW and REPAY; the Uniswap V3-style pool for SWAP; the ERC-4626 vault for VAULT_DEPOSIT and VAULT_WITHDRAW. Mixed case must be a valid EIP-55 checksum.","type":"string"},"sellToken":{"description":"SWAP only: the 0x address of the pool token you sell.","type":"string"},"slippageBps":{"description":"SWAP only, optional 1-1000: your slippage bound; default twice the price impact, at least 10 and at most 300 bps.","type":"integer"},"subjectNetworkId":{"description":"CAIP-2 chain of the subject (e.g. eip155:8453) or a supported alias such as base.","type":"string"}},"required":["query","subjectNetworkId","action","amount"],"type":"object","x-arbiter-contentType":"application/json","x-arbiter-schemaVersion":"1.0.0"},"method":"POST","operationId":"agenthubmachineaction_economics_quote","outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"citations":{"description":"Opaque content hashes for the public evidence used.","items":{},"type":"array"},"observedAt":{"description":"Newest observation timestamp represented in the result.","type":"string"},"recipe":{"description":"Recipe id and semantic version used to assemble the result.","type":"object"},"recipeRoot":{"description":"Content root of the exact recipe definition.","type":"string"},"sections":{"description":"Ordered results from the versioned primitive recipe.","items":{},"type":"array"},"subject":{"description":"Normalized subject or question accepted for the product.","type":"string"},"subjectNetworkId":{"description":"Canonical CAIP-2 subject chain, when material.","type":"string"},"uncertainty":{"description":"Plain-language limits of the evidence and inference in the result.","type":"string"}},"required":["recipe","subject","sections","citations","observedAt","uncertainty","recipeRoot"],"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.012,"mode":"DYNAMIC_QUOTE","ownerCeilingUsd":null,"pricingClass":"CURRENT_UNIT","publicStartingPriceUsd":0.012},"productId":"ACTION_ECONOMICS_QUOTE","productVersion":"2.0.0","provenance":{"basis":"CHAIN_STATE","protocols":["Aave V3","Uniswap V3-style pools","ERC-4626 vaults"],"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/ACTION_ECONOMICS_QUOTE","schemaVersion":"2.0.0","summary":"What will this action really cost, and what must happen for it to be worthwhile? For a supply, withdrawal, borrow or repayment on an Aave v3 market, a swap through a Uniswap V3-style pool, or a deposit into or withdrawal from an ERC-4626 vault, from one two-provider quorum read at a confirmed block: feasibility against caps, liquidity and flags; gas at the base fee plus the L2 data fee; protocol and pool fees; price impact and a slippage bound with the minimum output; borrow cost and expected yield over your holding period; the cost to unwind; the break-even (days, or the price move a round trip needs); the capital lockup; and the all-in cost. A bridge is refused before payment (no bridge route is priced). Example request: {\"query\":\"0xd0b53D9277642d899DF5C87A3966A349A798F224\",\"subjectNetworkId\":\"eip155:8453\",\"action\":\"SWAP\",\"sellToken\":\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\",\"amount\":\"40000\"}.","title":"Action economics: what a DeFi action really costs and when it pays"}