{ "x402Version": 2, "id": 33189, "slug": "33189", "resource": "https://api.3route.io/v1/pro/:chainId/quote/batch", "description": "Price several amounts or pairs at one block. Prices several quotes, each a pair with one or more amounts, against one chain state and reports its block. Prefer it to sequential quote calls when prices must be comparable, such as both sides of a book. Charged once per request. Supports exact-output amounts per quote and historical state for approximately 35 days; the first request for a block may take 1-7 seconds.", "type": "http", "serviceName": "3Route", "resourceType": "Utilities", "accepts": [ { "scheme": "exact", "network": "eip155:8453", "payTo": "0x5D89060682fcE50eCaa7600aF6A5645Bd2b107Eb", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "amount": "1000", "amountUsd": 0.001, "maxTimeoutSeconds": 300 }, { "scheme": "batch-settlement", "network": "eip155:8453", "payTo": "0x5D89060682fcE50eCaa7600aF6A5645Bd2b107Eb", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "amount": "30", "amountUsd": 0.00003, "maxTimeoutSeconds": 300 }, { "scheme": "exact", "network": "eip155:42793", "payTo": "0x5D89060682fcE50eCaa7600aF6A5645Bd2b107Eb", "asset": "0x796Ea11Fa2dD751eD01b53C372fFDB4AAa8f00F9", "amount": "1000", "maxTimeoutSeconds": 300 }, { "scheme": "exact", "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "payTo": "AZ59bSccJmQu8Ljic1c5zxhjZitVbbutUYjBNwKLqfyD", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "amount": "1000", "amountUsd": 0.001, "maxTimeoutSeconds": 300 } ], "outputSchema": { "properties": { "example": { "type": "object" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" }, "extensions": { "bazaar": { "info": { "input": { "body": { "blockNumber": 70524414, "quotes": [ { "amounts": [ "10000000", "20000000" ], "dst": "0xaf3d76f1834a1d425780943c99ea8a608f8a93f9", "src": "0x5fc5360d0400a0fd4f2af552add042d716f1d168" }, { "amounts": [ "30000000000000000" ], "dst": "0x5fc5360d0400a0fd4f2af552add042d716f1d168", "src": "0xaf3d76f1834a1d425780943c99ea8a608f8a93f9" } ] }, "bodyType": "json", "method": "POST", "pathParams": { "chainId": "42793" }, "type": "http" }, "output": { "example": { "blockNumber": 70524414, "result": [ { "dst": "0xaf3d76f1834a1d425780943c99ea8a608f8a93f9", "quotes": [ { "dstAmount": "29397783499279597", "gas": 2735000, "srcAmount": "10000000" }, { "dstAmount": "58721973396111804", "gas": 1948000, "srcAmount": "20000000" } ], "src": "0x5fc5360d0400a0fd4f2af552add042d716f1d168" }, { "dst": "0x5fc5360d0400a0fd4f2af552add042d716f1d168", "quotes": [ { "dstAmount": "10261672", "gas": 2482000, "srcAmount": "30000000000000000" } ], "src": "0xaf3d76f1834a1d425780943c99ea8a608f8a93f9" } ] }, "type": "json" } }, "routeTemplate": "/v1/pro/:chainId/quote/batch", "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "input": { "additionalProperties": false, "properties": { "body": { "additionalProperties": false, "description": "Every quote in the batch is answered from one chain state. The state selectors belong to the envelope only; blockNumber or timestamp inside a quote is rejected as an unknown field.", "properties": { "blockNumber": { "description": "Use historical state at this block for every quote. Cannot be combined with timestamp or reference a future block.", "minimum": 0, "type": "integer" }, "quotes": { "description": "Quotes to answer, currently at most 4 per request, with at most 100 amounts summed over all quotes. The limits can change; a request over them answers 400 naming the current limit.", "items": { "additionalProperties": false, "description": "One quote in a batch: a pair and the amounts to price for it. Options apply to this quote only, so the two sides of a book can be filtered or priced differently.", "properties": { "amounts": { "description": "Positive amounts in smallest units, as integer strings, priced against this pair. Uses src units by default, or dst units when isExactOutput=true. The response holds one element per amount, in request order.", "example": [ "10000000", "20000000" ], "items": { "pattern": "^[0-9]+$", "type": "string" }, "minItems": 1, "type": "array" }, "dst": { "description": "Address of the token being bought; take one from the token-list operation for the selected chain, or use the zero address, or the case-insensitive sentinel 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee, for the chain's native asset.", "example": "0xaf3d76f1834a1d425780943c99ea8a608f8a93f9", "pattern": "^0x[0-9a-fA-F]{40}$", "type": "string" }, "excludedProtocols": { "description": "Comma-separated deny-list of DEX provider names to exclude from routing. Unknown names are ignored.", "type": "string" }, "fee": { "default": 0, "description": "Referral fee in percent. It is deducted from the input and reflected in srcAmount. A value outside the range is rejected with 400.", "maximum": 3, "minimum": 0, "type": "number" }, "includeProtocols": { "default": false, "description": "Include route hops, pool addresses, expected input and output amounts, and shares in basis points.", "type": "boolean" }, "includeTokensInfo": { "default": false, "description": "Set true to add the srcToken and dstToken metadata objects to the response", "type": "boolean" }, "isExactOutput": { "default": false, "description": "Set true to use each entry of amounts as the desired dst output and calculate the required srcAmount.", "type": "boolean" }, "protocols": { "description": "Comma-separated allow-list of DEX provider names to route through. Omit it to allow every provider. Unknown names are ignored when at least one name is known, but a list in which no name is known is rejected with 400. Provider names come back in protocols when includeProtocols=true.", "type": "string" }, "src": { "description": "Address of the token being sold; use the zero address, or the case-insensitive sentinel 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee, for the chain's native asset", "example": "0x5fc5360d0400a0fd4f2af552add042d716f1d168", "pattern": "^0x[0-9a-fA-F]{40}$", "type": "string" } }, "required": [ "src", "dst", "amounts" ], "type": "object" }, "minItems": 1, "type": "array" }, "timestamp": { "description": "Use historical state at this Unix timestamp in seconds for every quote. Cannot be combined with blockNumber or reference a future time.", "minimum": 0, "type": "integer" } }, "required": [ "quotes" ], "type": "object" }, "bodyType": { "enum": [ "json", "form-data", "text" ], "type": "string" }, "method": { "enum": [ "POST" ], "type": "string" }, "pathParams": { "additionalProperties": false, "properties": { "chainId": { "description": "Chain ID for the operation.", "enum": [ "4663", "42793" ], "example": "4663", "pattern": "^[0-9]+$", "type": "string" } }, "required": [ "chainId" ], "type": "object" }, "type": { "const": "http", "type": "string" } }, "required": [ "type", "method", "bodyType", "body" ], "type": "object" }, "output": { "properties": { "example": { "type": "object" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" } }, "required": [ "input" ], "type": "object" } }, "erc20ApprovalGasSponsoring": { "info": { "description": "The facilitator broadcasts a pre-signed ERC-20 approve() transaction to grant Permit2 allowance.", "version": "1" }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "amount": { "description": "The amount approved (uint256). Always MaxUint256.", "pattern": "^[0-9]+$", "type": "string" }, "asset": { "description": "The address of the ERC-20 token contract.", "pattern": "^0x[a-fA-F0-9]{40}$", "type": "string" }, "from": { "description": "The address of the sender (token owner).", "pattern": "^0x[a-fA-F0-9]{40}$", "type": "string" }, "signedTransaction": { "description": "The RLP-encoded signed EIP-1559 transaction as a hex string.", "pattern": "^0x[a-fA-F0-9]+$", "type": "string" }, "spender": { "description": "The address of the spender (Canonical Permit2).", "pattern": "^0x[a-fA-F0-9]{40}$", "type": "string" }, "version": { "description": "Schema version identifier.", "pattern": "^[0-9]+(\\.[0-9]+)*$", "type": "string" } }, "required": [ "from", "asset", "spender", "amount", "signedTransaction", "version" ], "type": "object" } } }, "tags": [ "Swap", "bazaar", "erc20ApprovalGasSponsoring" ], "sourceHost": "api.3route.io", "lastUpdated": "2026-09-24T16:17:30.963Z", "quality": { "calls30d": 3, "uniquePayers30d": 2, "lastCalledAt": "2026-09-24T16:17:30.471Z" }, "metadata": { "serviceName": "3Route", "extensions": { "bazaar": { "info": { "input": { "body": { "blockNumber": 70524414, "quotes": [ { "amounts": [ "10000000", "20000000" ], "dst": "0xaf3d76f1834a1d425780943c99ea8a608f8a93f9", "src": "0x5fc5360d0400a0fd4f2af552add042d716f1d168" }, { "amounts": [ "30000000000000000" ], "dst": "0x5fc5360d0400a0fd4f2af552add042d716f1d168", "src": "0xaf3d76f1834a1d425780943c99ea8a608f8a93f9" } ] }, "bodyType": "json", "method": "POST", "pathParams": { "chainId": "42793" }, "type": "http" }, "output": { "example": { "blockNumber": 70524414, "result": [ { "dst": "0xaf3d76f1834a1d425780943c99ea8a608f8a93f9", "quotes": [ { "dstAmount": "29397783499279597", "gas": 2735000, "srcAmount": "10000000" }, { "dstAmount": "58721973396111804", "gas": 1948000, "srcAmount": "20000000" } ], "src": "0x5fc5360d0400a0fd4f2af552add042d716f1d168" }, { "dst": "0x5fc5360d0400a0fd4f2af552add042d716f1d168", "quotes": [ { "dstAmount": "10261672", "gas": 2482000, "srcAmount": "30000000000000000" } ], "src": "0xaf3d76f1834a1d425780943c99ea8a608f8a93f9" } ] }, "type": "json" } }, "routeTemplate": "/v1/pro/:chainId/quote/batch", "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "input": { "additionalProperties": false, "properties": { "body": { "additionalProperties": false, "description": "Every quote in the batch is answered from one chain state. The state selectors belong to the envelope only; blockNumber or timestamp inside a quote is rejected as an unknown field.", "properties": { "blockNumber": { "description": "Use historical state at this block for every quote. Cannot be combined with timestamp or reference a future block.", "minimum": 0, "type": "integer" }, "quotes": { "description": "Quotes to answer, currently at most 4 per request, with at most 100 amounts summed over all quotes. The limits can change; a request over them answers 400 naming the current limit.", "items": { "additionalProperties": false, "description": "One quote in a batch: a pair and the amounts to price for it. Options apply to this quote only, so the two sides of a book can be filtered or priced differently.", "properties": { "amounts": { "description": "Positive amounts in smallest units, as integer strings, priced against this pair. Uses src units by default, or dst units when isExactOutput=true. The response holds one element per amount, in request order.", "example": [ "10000000", "20000000" ], "items": { "pattern": "^[0-9]+$", "type": "string" }, "minItems": 1, "type": "array" }, "dst": { "description": "Address of the token being bought; take one from the token-list operation for the selected chain, or use the zero address, or the case-insensitive sentinel 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee, for the chain's native asset.", "example": "0xaf3d76f1834a1d425780943c99ea8a608f8a93f9", "pattern": "^0x[0-9a-fA-F]{40}$", "type": "string" }, "excludedProtocols": { "description": "Comma-separated deny-list of DEX provider names to exclude from routing. Unknown names are ignored.", "type": "string" }, "fee": { "default": 0, "description": "Referral fee in percent. It is deducted from the input and reflected in srcAmount. A value outside the range is rejected with 400.", "maximum": 3, "minimum": 0, "type": "number" }, "includeProtocols": { "default": false, "description": "Include route hops, pool addresses, expected input and output amounts, and shares in basis points.", "type": "boolean" }, "includeTokensInfo": { "default": false, "description": "Set true to add the srcToken and dstToken metadata objects to the response", "type": "boolean" }, "isExactOutput": { "default": false, "description": "Set true to use each entry of amounts as the desired dst output and calculate the required srcAmount.", "type": "boolean" }, "protocols": { "description": "Comma-separated allow-list of DEX provider names to route through. Omit it to allow every provider. Unknown names are ignored when at least one name is known, but a list in which no name is known is rejected with 400. Provider names come back in protocols when includeProtocols=true.", "type": "string" }, "src": { "description": "Address of the token being sold; use the zero address, or the case-insensitive sentinel 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee, for the chain's native asset", "example": "0x5fc5360d0400a0fd4f2af552add042d716f1d168", "pattern": "^0x[0-9a-fA-F]{40}$", "type": "string" } }, "required": [ "src", "dst", "amounts" ], "type": "object" }, "minItems": 1, "type": "array" }, "timestamp": { "description": "Use historical state at this Unix timestamp in seconds for every quote. Cannot be combined with blockNumber or reference a future time.", "minimum": 0, "type": "integer" } }, "required": [ "quotes" ], "type": "object" }, "bodyType": { "enum": [ "json", "form-data", "text" ], "type": "string" }, "method": { "enum": [ "POST" ], "type": "string" }, "pathParams": { "additionalProperties": false, "properties": { "chainId": { "description": "Chain ID for the operation.", "enum": [ "4663", "42793" ], "example": "4663", "pattern": "^[0-9]+$", "type": "string" } }, "required": [ "chainId" ], "type": "object" }, "type": { "const": "http", "type": "string" } }, "required": [ "type", "method", "bodyType", "body" ], "type": "object" }, "output": { "properties": { "example": { "type": "object" }, "type": { "type": "string" } }, "required": [ "type" ], "type": "object" } }, "required": [ "input" ], "type": "object" } }, "erc20ApprovalGasSponsoring": { "info": { "description": "The facilitator broadcasts a pre-signed ERC-20 approve() transaction to grant Permit2 allowance.", "version": "1" }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "amount": { "description": "The amount approved (uint256). Always MaxUint256.", "pattern": "^[0-9]+$", "type": "string" }, "asset": { "description": "The address of the ERC-20 token contract.", "pattern": "^0x[a-fA-F0-9]{40}$", "type": "string" }, "from": { "description": "The address of the sender (token owner).", "pattern": "^0x[a-fA-F0-9]{40}$", "type": "string" }, "signedTransaction": { "description": "The RLP-encoded signed EIP-1559 transaction as a hex string.", "pattern": "^0x[a-fA-F0-9]+$", "type": "string" }, "spender": { "description": "The address of the spender (Canonical Permit2).", "pattern": "^0x[a-fA-F0-9]{40}$", "type": "string" }, "version": { "description": "Schema version identifier.", "pattern": "^[0-9]+(\\.[0-9]+)*$", "type": "string" } }, "required": [ "from", "asset", "spender", "amount", "signedTransaction", "version" ], "type": "object" } } } }, "liveness": { "reliability": null }, "verified": false, "featured": false, "provider": { "host": "api.3route.io", "manifest_name": "api.3route.io", "source": "cdp-mirror", "source_manifest_url": "https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources", "submitted_at": "2026-10-14T01:15:01.050Z" }, "exampleResponse": { "example": {}, "type": "string" } }