Get Intent Status Array

curl --request POST \
  --url https://quotes.eco.com/api/v3/intents/status \
  --header 'Content-Type: application/json' \
  --data '
{
  "intentHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
  "intentCreatedHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab",
  "fulfillmentHash": "0x567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef123456"
}
'

{
  "data": [
    {
      "intentHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
      "status": {
        "status": "Pending",
        "subStatus": "WaitingToFulfill",
        "subStatusMessage": "The intent is waiting to be fulfilled"
      },
      "intentData": {
        "sourceChainID": 42161,
        "destinationChainID": 167000,
        "creator": "0x1234567890abcdef1234567890abcdef12345678",
        "deadline": 1730000000,
        "createdAt": 1729500000,
        "sourceTransfers": [
          {
            "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
            "amount": "1000000"
          }
        ],
        "destinationTransfers": [
          {
            "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
            "amount": "1000000",
            "recipient": "0x054968e2f376192c69b8f30870d450519ff77ac8"
          }
        ],
        "refundRecipient": "0x1234567890abcdef1234567890abcdef12345678"
      },
      "sendingTxs": [
        {
          "chainId": 42161,
          "timestamp": 1729163645,
          "txHash": "0xe1ffdcf09d5aa92a2d89b1b39db3f8cadf09428a296cce0d5e387595ac83d08f",
          "txLink": "https://arbiscan.io/tx/0xe1ffdcf09d5aa92a2d89b1b39db3f8cadf09428a296cce0d5e387595ac83d08f",
          "transfers": [
            {
              "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "amount": "1000000"
            }
          ]
        }
      ],
      "receivingTxs": [
        {
          "chainId": 10,
          "timestamp": 1729164000,
          "txHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
          "txLink": "https://optimistic.etherscan.io/tx/0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
          "transfers": [
            {
              "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "amount": "1000000",
              "recipient": "0x054968e2f376192c69b8f30870d450519ff77ac8"
            }
          ]
        }
      ]
    }
  ]
}

POST

api

intents

status

Get Intent Status Array

curl --request POST \
  --url https://quotes.eco.com/api/v3/intents/status \
  --header 'Content-Type: application/json' \
  --data '
{
  "intentHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
  "intentCreatedHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab",
  "fulfillmentHash": "0x567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef123456"
}
'

{
  "data": [
    {
      "intentHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
      "status": {
        "status": "Pending",
        "subStatus": "WaitingToFulfill",
        "subStatusMessage": "The intent is waiting to be fulfilled"
      },
      "intentData": {
        "sourceChainID": 42161,
        "destinationChainID": 167000,
        "creator": "0x1234567890abcdef1234567890abcdef12345678",
        "deadline": 1730000000,
        "createdAt": 1729500000,
        "sourceTransfers": [
          {
            "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
            "amount": "1000000"
          }
        ],
        "destinationTransfers": [
          {
            "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
            "amount": "1000000",
            "recipient": "0x054968e2f376192c69b8f30870d450519ff77ac8"
          }
        ],
        "refundRecipient": "0x1234567890abcdef1234567890abcdef12345678"
      },
      "sendingTxs": [
        {
          "chainId": 42161,
          "timestamp": 1729163645,
          "txHash": "0xe1ffdcf09d5aa92a2d89b1b39db3f8cadf09428a296cce0d5e387595ac83d08f",
          "txLink": "https://arbiscan.io/tx/0xe1ffdcf09d5aa92a2d89b1b39db3f8cadf09428a296cce0d5e387595ac83d08f",
          "transfers": [
            {
              "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "amount": "1000000"
            }
          ]
        }
      ],
      "receivingTxs": [
        {
          "chainId": 10,
          "timestamp": 1729164000,
          "txHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
          "txLink": "https://optimistic.etherscan.io/tx/0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
          "transfers": [
            {
              "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "amount": "1000000",
              "recipient": "0x054968e2f376192c69b8f30870d450519ff77ac8"
            }
          ]
        }
      ]
    }
  ]
}

Body

application/json

intentHash

string

Hash of the intent to query status for

Example:

"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12"

intentCreatedHash

string

Transaction hash of the intent creation transaction

Example:

"0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab"

fulfillmentHash

string

Transaction hash of the intent fulfillment transaction

Example:

"0x567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef123456"

Response

Successfully retrieved array of intent statuses ordered by log index

data

object[]

required

Array of intent statuses matching the search criteria (with log indexes and timestamps)

Show child attributes

data.intentHash

string

required

Hash of the intent being tracked

Example:

"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12"

data.status

object

required

Current status and sub-status of the intent execution

Show child attributes

data.status.status

enum<string>

required

High-level status of the intent (Pending or Completed)

Available options:

Pending,

Completed

Example:

"Pending"

data.status.subStatus

enum<string>

required

Detailed status indicating the specific stage of intent execution

Available options:

WaitingToFulfill,

WaitingForRefund,

Fulfilled,

Refunded

Example:

"WaitingToFulfill"

data.status.subStatusMessage

string

required

Human-readable description of the substatus

Example:

"The intent is waiting to be fulfilled"

data.intentData

object

required

Intent definition data including chain IDs, creator, deadline, and transfers

Show child attributes

data.intentData.sourceChainID

number

required

Source chain ID where the intent was created

Example:

42161

data.intentData.destinationChainID

number

required

Destination chain ID where the intent will be fulfilled

Example:

167000

data.intentData.creator

string

required

Address that created the intent

Example:

"0x1234567890abcdef1234567890abcdef12345678"

data.intentData.deadline

number

required

Unix timestamp when the intent expires and becomes refundable

Example:

1730000000

data.intentData.createdAt

number

required

Unix timestamp when the intent was created

Example:

1729500000

data.intentData.sourceTransfers

object[]

required

Array of reward token transfers (what the prover receives from the creator). Does not include recipients.

Show child attributes

data.intentData.sourceTransfers.token

string

required

Token address (use "0x" for native tokens)

Example:

"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"

data.intentData.sourceTransfers.amount

string

required

Token amount as string

Example:

"1000000"

Example:

[
  {
    "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "1000000"
  }
]

data.intentData.destinationTransfers

object[]

required

Array of destination transfers (tokens and recipients on the destination chain). Always includes recipients.

Show child attributes

data.intentData.destinationTransfers.token

string

required

Token address (use "0x" for native tokens)

Example:

"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"

data.intentData.destinationTransfers.amount

string

required

Token amount as string

Example:

"1000000"

data.intentData.destinationTransfers.recipient

string

required

Recipient address for this transfer

Example:

"0x9876543210abcdef9876543210abcdef98765432"

Example:

[
  {
    "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "1000000",
    "recipient": "0x054968e2f376192c69b8f30870d450519ff77ac8"
  }
]

data.intentData.refundRecipient

string

Address that received the refund (only set when intent has been refunded)

Example:

"0x1234567890abcdef1234567890abcdef12345678"

data.sendingTxs

object[]

required

Transactions that sent tokens on the source chain (intent creation). Transfers do not include recipients.

Show child attributes

data.sendingTxs.chainId

number

required

Chain ID where this transaction occurred

Example:

42161

data.sendingTxs.timestamp

number

required

Unix timestamp of the transaction

Example:

1729163645

data.sendingTxs.txHash

string

required

Transaction hash

Example:

"0xe1ffdcf09d5aa92a2d89b1b39db3f8cadf09428a296cce0d5e387595ac83d08f"

data.sendingTxs.txLink

string

required

Block explorer URL for this transaction

Example:

"https://arbiscan.io/tx/0xe1ffdcf09d5aa92a2d89b1b39db3f8cadf09428a296cce0d5e387595ac83d08f"

data.sendingTxs.transfers

object[]

required

Token transfers associated with this transaction. Source transfers (sendingTxs) do not include recipients. Destination transfers (receivingTxs) include recipients.

Option 1
Option 2

Show child attributes

data.sendingTxs.transfers.token

string

required

Token address (use "0x" for native tokens)

Example:

"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"

data.sendingTxs.transfers.amount

string

required

Token amount as string

Example:

"1000000"

Example:

[
  {
    "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "1000000",
    "recipient": "0x054968e2f376192c69b8f30870d450519ff77ac8"
  }
]

Example:

[
  {
    "chainId": 42161,
    "timestamp": 1729163645,
    "txHash": "0xe1ffdcf09d5aa92a2d89b1b39db3f8cadf09428a296cce0d5e387595ac83d08f",
    "txLink": "https://arbiscan.io/tx/0xe1ffdcf09d5aa92a2d89b1b39db3f8cadf09428a296cce0d5e387595ac83d08f",
    "transfers": [
      {
        "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "amount": "1000000"
      }
    ]
  }
]

data.receivingTxs

object[]

required

Transactions that received tokens on the destination chain (fulfillment or refund). Transfers always include recipients.

Show child attributes

data.receivingTxs.chainId

number

required

Chain ID where this transaction occurred

Example:

42161

data.receivingTxs.timestamp

number

required

Unix timestamp of the transaction

Example:

1729163645

data.receivingTxs.txHash

string

required

Transaction hash

Example:

"0xe1ffdcf09d5aa92a2d89b1b39db3f8cadf09428a296cce0d5e387595ac83d08f"

data.receivingTxs.txLink

string

required

Block explorer URL for this transaction

Example:

"https://arbiscan.io/tx/0xe1ffdcf09d5aa92a2d89b1b39db3f8cadf09428a296cce0d5e387595ac83d08f"

data.receivingTxs.transfers

object[]

required

Token transfers associated with this transaction. Source transfers (sendingTxs) do not include recipients. Destination transfers (receivingTxs) include recipients.

Option 1
Option 2

Show child attributes

data.receivingTxs.transfers.token

string

required

Token address (use "0x" for native tokens)

Example:

"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"

data.receivingTxs.transfers.amount

string

required

Token amount as string

Example:

"1000000"

Example:

[
  {
    "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "1000000",
    "recipient": "0x054968e2f376192c69b8f30870d450519ff77ac8"
  }
]

Example:

[
  {
    "chainId": 10,
    "timestamp": 1729164000,
    "txHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
    "txLink": "https://optimistic.etherscan.io/tx/0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
    "transfers": [
      {
        "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "amount": "1000000",
        "recipient": "0x054968e2f376192c69b8f30870d450519ff77ac8"
      }
    ]
  }
]

Get Intent Status Register Solver

⌘I

Getting started

Quote endpoints

Registering a solver

API interface for solvers

Get Intent Status Array

Body

Response