Get Exact In Quotes

curl --request POST \
  --url https://quotes.eco.com/api/v3/quotes/exactIn \
  --header 'Content-Type: application/json' \
  --data '
{
  "dAppID": "my-dapp",
  "intentExecutionTypes": [
    "SELF_PUBLISH"
  ],
  "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": [
    {
      "quoteID": "<string>",
      "solverID": "<string>",
      "receiveSignedIntentUrl": "<string>",
      "quoteData": {
        "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"
        }
      }
    }
  ]
}

POST

api

quotes

exactIn

Get Exact In Quotes

curl --request POST \
  --url https://quotes.eco.com/api/v3/quotes/exactIn \
  --header 'Content-Type: application/json' \
  --data '
{
  "dAppID": "my-dapp",
  "intentExecutionTypes": [
    "SELF_PUBLISH"
  ],
  "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": [
    {
      "quoteID": "<string>",
      "solverID": "<string>",
      "receiveSignedIntentUrl": "<string>",
      "quoteData": {
        "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

dAppID

string

required

Unique identifier for the client application making the request

Example:

"my-dapp"

intentExecutionTypes

enum<string>[]

required

Array of intent execution types to fetch quotes for

Available options:

SELF_PUBLISH,

GASLESS

Example:

["SELF_PUBLISH"]

quoteRequest

object

required

Cross-chain token swap request details including source/destination tokens and addresses

Show child attributes

quoteRequest.sourceChainID

number

required

Chain ID of the source network where tokens will be sent from

Example:

1

quoteRequest.destinationChainID

number

required

Chain ID of the destination network where tokens will be received

Example:

42161

quoteRequest.sourceToken

string

required

Contract address of the token being sent on the source chain

Example:

"0xA0b86a33E6441e45C3b9d1C3D6a0b5be4b7b5b5a"

quoteRequest.destinationToken

string

required

Contract address of the token to be received on the destination chain

Example:

"0xFF970A61A04b1cA14834A43f5dE4533eBDDB5CC8"

quoteRequest.sourceAmount

string

required

Amount of source tokens to send, specified as a string representation of a bigint

Example:

"1000000"

quoteRequest.funder

string

required

Address that will provide the tokens and pay for the transaction

Example:

"0x742d35Cc6527C92b4A1F3a2a8b1c9b3e8c4c5b2a"

quoteRequest.recipient

string

required

Address that will receive the tokens on the destination chain

Example:

"0x8Ba1c0a8B4A4b9e8A9f1a6B7c8d9e0F1234567890"

quoteRequest.refundRecipient

string

Address to receive refunds if the intent fails (defaults to funder if not specified)

Example:

"0x742d35Cc6527C92b4A1F3a2a8b1c9b3e8c4c5b2a"

contracts

object

Optional contract addresses to use for the cross-chain swap (will use defaults if not specified)

Show child attributes

contracts.sourcePortal

string

Contract address for the intent source (where intents are created and managed)

Example:

"0x1234567890abcdef1234567890abcdef12345678"

contracts.destinationPortal

string

Contract address for the inbox (receives and processes cross-chain messages)

Example:

"0x567890abcdef1234567890abcdef1234567890ab"

contracts.prover

string

Contract address for the prover (handles cross-chain proof verification)

Example:

"0xabcdef1234567890abcdef1234567890abcdef12"

Response

201 - application/json

Successfully retrieved exact in quotes from solvers

data

object[]

required

Array of solver quote responses

Show child attributes

data.quoteID

string

required

data.solverID

string

required

data.receiveSignedIntentUrl

string

required

data.quoteData

object

required

Show child attributes

data.quoteData.contracts

object

required

Contract addresses required for executing this cross-chain swap

Show child attributes

data.quoteData.contracts.sourcePortal

string

required

Contract address for the intent source (where intents are created and managed)

Example:

"0x1234567890abcdef1234567890abcdef12345678"

data.quoteData.contracts.destinationPortal

string

required

Contract address for the inbox (receives and processes cross-chain messages)

Example:

"0x567890abcdef1234567890abcdef1234567890ab"

data.quoteData.contracts.prover

string

required

Contract address for the prover (handles cross-chain proof verification)

Example:

"0xabcdef1234567890abcdef1234567890abcdef12"

data.quoteData.quoteResponse

object

Detailed quote information including tokens, amounts, fees, and timing

Show child attributes

data.quoteData.quoteResponse.intentExecutionType

enum<string>

required

The execution type for this quote entry

Available options:

SELF_PUBLISH,

GASLESS

Example:

"SELF_PUBLISH"

data.quoteData.quoteResponse.sourceChainID

number

required

Chain ID of the source network where tokens will be sent from

Example:

1

data.quoteData.quoteResponse.destinationChainID

number

required

Chain ID of the destination network where tokens will be received

Example:

42161

data.quoteData.quoteResponse.sourceToken

string

required

Contract address of the token being sent on the source chain

Example:

"0xA0b86a33E6441e45C3b9d1C3D6a0b5be4b7b5b5a"

data.quoteData.quoteResponse.destinationToken

string

required

Contract address of the token to be received on the destination chain

Example:

"0xFF970A61A04b1cA14834A43f5dE4533eBDDB5CC8"

data.quoteData.quoteResponse.sourceAmount

string

required

Amount of source tokens to send, as a string representation of a bigint

Example:

"1000000"

data.quoteData.quoteResponse.destinationAmount

string

required

Amount of destination tokens to be received, as a string representation of a bigint

Example:

"995000"

data.quoteData.quoteResponse.funder

string

required

Address that will provide the tokens and pay for the transaction

Example:

"0x742d35Cc6527C92b4A1F3a2a8b1c9b3e8c4c5b2a"

data.quoteData.quoteResponse.refundRecipient

string

required

Address to receive refunds if the intent fails

Example:

"0x742d35Cc6527C92b4A1F3a2a8b1c9b3e8c4c5b2a"

data.quoteData.quoteResponse.recipient

string

required

Address that will receive the tokens on the destination chain

Example:

"0x8Ba1c0a8B4A4b9e8A9f1a6B7c8d9e0F1234567890"

data.quoteData.quoteResponse.fees

object[]

required

Array of fees that will be charged for executing this cross-chain swap

Show child attributes

data.quoteData.quoteResponse.fees.name

string

required

Name identifier for the fee type

Example:

"Solver Fee"

data.quoteData.quoteResponse.fees.description

string

required

Human-readable description of what this fee covers

Example:

"Fee paid to the solver for executing the cross-chain swap"

data.quoteData.quoteResponse.fees.token

object

required

Token information for the fee payment

Show child attributes

data.quoteData.quoteResponse.fees.token.address

string

required

Contract address of the token

Example:

"0xA0b86a33E6441e45C3b9d1C3D6a0b5be4b7b5b5a"

data.quoteData.quoteResponse.fees.token.decimals

number

required

Number of decimal places for the token

Example:

6

data.quoteData.quoteResponse.fees.token.symbol

string

required

Token symbol or ticker

Example:

"USDC"

data.quoteData.quoteResponse.fees.amount

string

required

Fee amount as a string representation of a bigint

Example:

"1000"

data.quoteData.quoteResponse.deadline

number

required

Unix timestamp (in seconds) after which this quote expires and cannot be executed

Example:

1672531200

data.quoteData.quoteResponse.estimatedFulfillTimeSec

number

required

Estimated time in seconds for the cross-chain swap to be completed

Example:

300

data.quoteData.quoteResponse.encodedRoute

string

required

ABI-encoded route data for on-chain intent execution

Example:

"0x00000000000000000000000000000000000000000000000000000000000000202810ea6d0860ce5315ef2b62b1b580f2b4ef158b76a6ea8f8982600c130e55e70000000000000000000000000000000000000000000000000000000068e56fa2000000000000000000000000b5e58a8206473dc3ab9b8d4d3b0f84c0ba68f8b5000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000c000000000000000000000000000000000000000000000000000000000000001200000000000000000000000000000000000000000000000000000000000000001000000000000000000000000833589fcd6edb6e082dc7c32d4f71b54bda0291300000000000000000000000000000000000000000000000000000000004bd61000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000020000000000000000000000000833589fcd6edb6e08f4c7c32d4f71b54bda02913000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000044a9059cbb0000000000000000000000002b2c52b1b63c4bfc7f16910a1734641d8e34de6200000000000000000000000000000000000000000000000000000000004bd61000000000000000000000000000000000000000000000000000000000"

Get Single Quote Get Exact Out Quotes

⌘I

Getting started

Quote endpoints

Registering a solver

API interface for solvers

Get Exact In Quotes

Body

Response