Get Single Quote
curl --request POST \
--url https://quotes.eco.com/api/v3/quotes/single \
--header 'Content-Type: application/json' \
--data '
{
"dAppID": "my-dapp",
"quoteRequest": {
"sourceChainID": 1,
"destinationChainID": 42161,
"sourceToken": "0xA0b86a33E6441e45C3b9d1C3D6a0b5be4b7b5b5a",
"destinationToken": "0xFF970A61A04b1cA14834A43f5dE4533eBDDB5CC8",
"sourceAmount": "1000000",
"funder": "0x742d35Cc6527C92b4A1F3a2a8b1c9b3e8c4c5b2a",
"recipient": "0x8Ba1c0a8B4A4b9e8A9f1a6B7c8d9e0F1234567890",
"refundRecipient": "0x742d35Cc6527C92b4A1F3a2a8b1c9b3e8c4c5b2a"
},
"contracts": {
"sourcePortal": "0x1234567890abcdef1234567890abcdef12345678",
"destinationPortal": "0x567890abcdef1234567890abcdef1234567890ab",
"prover": "0xabcdef1234567890abcdef1234567890abcdef12"
}
}
'{
"data": {
"contracts": {
"sourcePortal": "0x1234567890abcdef1234567890abcdef12345678",
"destinationPortal": "0x567890abcdef1234567890abcdef1234567890ab",
"prover": "0xabcdef1234567890abcdef1234567890abcdef12"
},
"quoteResponse": {
"intentExecutionType": "SELF_PUBLISH",
"sourceChainID": 1,
"destinationChainID": 42161,
"sourceToken": "0xA0b86a33E6441e45C3b9d1C3D6a0b5be4b7b5b5a",
"destinationToken": "0xFF970A61A04b1cA14834A43f5dE4533eBDDB5CC8",
"sourceAmount": "1000000",
"destinationAmount": "995000",
"funder": "0x742d35Cc6527C92b4A1F3a2a8b1c9b3e8c4c5b2a",
"refundRecipient": "0x742d35Cc6527C92b4A1F3a2a8b1c9b3e8c4c5b2a",
"recipient": "0x8Ba1c0a8B4A4b9e8A9f1a6B7c8d9e0F1234567890",
"fees": [
{
"name": "Solver Fee",
"description": "Fee paid to the solver for executing the cross-chain swap",
"token": {
"address": "0xA0b86a33E6441e45C3b9d1C3D6a0b5be4b7b5b5a",
"decimals": 6,
"symbol": "USDC"
},
"amount": "1000"
}
],
"deadline": 1672531200,
"estimatedFulfillTimeSec": 300,
"encodedRoute": "0x00000000000000000000000000000000000000000000000000000000000000202810ea6d0860ce5315ef2b62b1b580f2b4ef158b76a6ea8f8982600c130e55e70000000000000000000000000000000000000000000000000000000068e56fa2000000000000000000000000b5e58a8206473dc3ab9b8d4d3b0f84c0ba68f8b5000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000c000000000000000000000000000000000000000000000000000000000000001200000000000000000000000000000000000000000000000000000000000000001000000000000000000000000833589fcd6edb6e082dc7c32d4f71b54bda0291300000000000000000000000000000000000000000000000000000000004bd61000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000020000000000000000000000000833589fcd6edb6e08f4c7c32d4f71b54bda02913000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000044a9059cbb0000000000000000000000002b2c52b1b63c4bfc7f16910a1734641d8e34de6200000000000000000000000000000000000000000000000000000000004bd61000000000000000000000000000000000000000000000000000000000"
}
}
}Quotes & Intents
Get Single Quote
Retrieve the best quote for a cross-chain single token swap. Returns detailed pricing, fees, contract addresses, and estimated fulfillment time for the requested swap. This endpoint should only be used for intents intended to be published onchain.
POST
/
api
/
v3
/
quotes
/
single
Get Single Quote
curl --request POST \
--url https://quotes.eco.com/api/v3/quotes/single \
--header 'Content-Type: application/json' \
--data '
{
"dAppID": "my-dapp",
"quoteRequest": {
"sourceChainID": 1,
"destinationChainID": 42161,
"sourceToken": "0xA0b86a33E6441e45C3b9d1C3D6a0b5be4b7b5b5a",
"destinationToken": "0xFF970A61A04b1cA14834A43f5dE4533eBDDB5CC8",
"sourceAmount": "1000000",
"funder": "0x742d35Cc6527C92b4A1F3a2a8b1c9b3e8c4c5b2a",
"recipient": "0x8Ba1c0a8B4A4b9e8A9f1a6B7c8d9e0F1234567890",
"refundRecipient": "0x742d35Cc6527C92b4A1F3a2a8b1c9b3e8c4c5b2a"
},
"contracts": {
"sourcePortal": "0x1234567890abcdef1234567890abcdef12345678",
"destinationPortal": "0x567890abcdef1234567890abcdef1234567890ab",
"prover": "0xabcdef1234567890abcdef1234567890abcdef12"
}
}
'{
"data": {
"contracts": {
"sourcePortal": "0x1234567890abcdef1234567890abcdef12345678",
"destinationPortal": "0x567890abcdef1234567890abcdef1234567890ab",
"prover": "0xabcdef1234567890abcdef1234567890abcdef12"
},
"quoteResponse": {
"intentExecutionType": "SELF_PUBLISH",
"sourceChainID": 1,
"destinationChainID": 42161,
"sourceToken": "0xA0b86a33E6441e45C3b9d1C3D6a0b5be4b7b5b5a",
"destinationToken": "0xFF970A61A04b1cA14834A43f5dE4533eBDDB5CC8",
"sourceAmount": "1000000",
"destinationAmount": "995000",
"funder": "0x742d35Cc6527C92b4A1F3a2a8b1c9b3e8c4c5b2a",
"refundRecipient": "0x742d35Cc6527C92b4A1F3a2a8b1c9b3e8c4c5b2a",
"recipient": "0x8Ba1c0a8B4A4b9e8A9f1a6B7c8d9e0F1234567890",
"fees": [
{
"name": "Solver Fee",
"description": "Fee paid to the solver for executing the cross-chain swap",
"token": {
"address": "0xA0b86a33E6441e45C3b9d1C3D6a0b5be4b7b5b5a",
"decimals": 6,
"symbol": "USDC"
},
"amount": "1000"
}
],
"deadline": 1672531200,
"estimatedFulfillTimeSec": 300,
"encodedRoute": "0x00000000000000000000000000000000000000000000000000000000000000202810ea6d0860ce5315ef2b62b1b580f2b4ef158b76a6ea8f8982600c130e55e70000000000000000000000000000000000000000000000000000000068e56fa2000000000000000000000000b5e58a8206473dc3ab9b8d4d3b0f84c0ba68f8b5000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000c000000000000000000000000000000000000000000000000000000000000001200000000000000000000000000000000000000000000000000000000000000001000000000000000000000000833589fcd6edb6e082dc7c32d4f71b54bda0291300000000000000000000000000000000000000000000000000000000004bd61000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000020000000000000000000000000833589fcd6edb6e08f4c7c32d4f71b54bda02913000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000044a9059cbb0000000000000000000000002b2c52b1b63c4bfc7f16910a1734641d8e34de6200000000000000000000000000000000000000000000000000000000004bd61000000000000000000000000000000000000000000000000000000000"
}
}
}Body
application/json
Unique identifier for the client application making the request
Example:
"my-dapp"
Cross-chain token swap request details including source/destination tokens and addresses
Show child attributes
Show child attributes
Optional contract addresses to use for the cross-chain swap (will use defaults if not specified)
Show child attributes
Show child attributes
Response
200 - application/json
Successfully retrieved quote with pricing and execution details
Quote response data
Show child attributes
Show child attributes
⌘I
