Get Intent Status

curl --request POST \
  --url https://quotes.eco.com/api/v3/intents/intentStatus \
  --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"
    },
    "intentCreated": {
      "chainId": 1,
      "transactionHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
      "blockExplorerUrl": "https://etherscan.io/tx/0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12"
    },
    "fulfillment": {
      "chainId": 1,
      "transactionHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
      "blockExplorerUrl": "https://etherscan.io/tx/0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12"
    },
    "refund": {
      "chainId": 1,
      "transactionHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
      "blockExplorerUrl": "https://etherscan.io/tx/0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12"
    }
  }
}

POST

api

intents

intentStatus

Get Intent Status

curl --request POST \
  --url https://quotes.eco.com/api/v3/intents/intentStatus \
  --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"
    },
    "intentCreated": {
      "chainId": 1,
      "transactionHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
      "blockExplorerUrl": "https://etherscan.io/tx/0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12"
    },
    "fulfillment": {
      "chainId": 1,
      "transactionHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
      "blockExplorerUrl": "https://etherscan.io/tx/0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12"
    },
    "refund": {
      "chainId": 1,
      "transactionHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
      "blockExplorerUrl": "https://etherscan.io/tx/0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12"
    }
  }
}

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

200 - application/json

Successfully retrieved intent status and transaction details

data

object

required

Intent status response data

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.intentCreated

object

required

Transaction details for when the intent was created

Show child attributes

data.intentCreated.chainId

number

required

Chain ID where this transaction occurred

Example:

1

data.intentCreated.transactionHash

string

required

Hash of the transaction

Example:

"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12"

data.intentCreated.blockExplorerUrl

string

required

URL to view this transaction on a block explorer

Example:

"https://etherscan.io/tx/0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12"

data.fulfillment

object

Transaction details for when the intent was fulfilled (if completed)

Show child attributes

data.fulfillment.chainId

number

required

Chain ID where this transaction occurred

Example:

1

data.fulfillment.transactionHash

string

required

Hash of the transaction

Example:

"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12"

data.fulfillment.blockExplorerUrl

string

required

URL to view this transaction on a block explorer

Example:

"https://etherscan.io/tx/0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12"

data.refund

object

Transaction details for when the intent was refunded (if refunded)

Show child attributes

data.refund.chainId

number

required

Chain ID where this transaction occurred

Example:

1

data.refund.transactionHash

string

required

Hash of the transaction

Example:

"0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12"

data.refund.blockExplorerUrl

string

required

URL to view this transaction on a block explorer

Example:

"https://etherscan.io/tx/0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12"

Initiate Gasless Intent Get Intent Status Array

⌘I

Getting started

Quote endpoints

Registering a solver

API interface for solvers

Get Intent Status

Body

Response