Get order status by hash

Retrieves detailed information about a specific order including its status, fills, auction parameters, and metadata

GEThttps://api.1inch.com/fusion/orders/v2.0/{chain}/order/status/{orderHash}
Supported on:
EthereumBaseSolanaBNB ChainArcMonadOptimismPolygonLineaSonicUnichainRobinhood ChainArbitrumAvalancheCronosZKsyncGnosisHyperEVM

Parameters

chain
* number path
orderHash
* string path
Unique hash identifier of the order (66 character hex string with 0x prefix)

Request Body

This request doesn’t have any request body.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
const axios = require('axios');

async function httpCall() {
  const url =
    'https://api.1inch.com/fusion/orders/v2.0/{chain}/order/status/{orderHash}';

  const config = {
    headers: {
      Authorization: `Bearer ${API_KEY}`,
    },
    params: {},
    paramsSerializer: {
      indexes: null,
    },
  };

  try {
    const response = await axios.get(url, config);
    console.log(response.data);
  } catch (error) {
    console.error(error);
  }
}

Returns

GetOrderFillsByHashOutput object
Detailed order status with fill history, auction parameters, and execution metadata
orderHash
* string
Order hash
maker
* string
Real maker address (extracted from signature for native orders)
status
* string (Enum)
Order status
pending
filled
false-predicate
not-enough-balance-or-allowance
expired
partially-filled
wrong-permit
cancelled
invalid-signature
invalid-maker-traits
awaiting-signatures
unpublished
order
* any
Order data
allOf[0]
LimitOrderV4StructOutput object
Limit Order V4 structure compatible with 1inch Limit Order Protocol
salt
* string
Unique salt value to differentiate orders with same parameters
maker
* string
Maker address
receiver
* string
Receiver address
makerAsset
* string
Maker asset address
takerAsset
* string
Taker asset address
makingAmount
* string
Amount of the maker asset
takingAmount
* string
Amount of the taker asset
makerTraits
* string
Encoded maker traits including flags for partial fills, multiple fills, deadlines, etc.
extension
* object
An interaction call data. ABI encoded set of makerAssetSuffix, takerAssetSuffix, makingAmountGetter, takingAmountGetter, predicate, permit, preInteraction, postInteraction.If extension exists then lowest 160 bits of the order salt must be equal to the lowest 160 bits of the extension hash
points
* array
Auction price curve points defining rate changes over time
items
AuctionPointOutput object
Point in the auction price curve defining rate changes over time
delay
* number
The delay in seconds from the previous point or auction start time
coefficient
* number
The rate bump from the order min taker amount
approximateTakingAmount
* string
Approximate amount of the takerAsset being requested by the maker in dst chain.
fills
* array
Fills
items
FillsOutput object
Order fill transaction details with amounts and fees
txHash
* string
Transaction hash
filledMakerAmount
* string
Amount of the makerAsset filled in src chain.
filledAuctionTakerAmount
* string
Amount of the takerAsset filled in dst chain.
takerFeeAmount
* string
Total taker fee, including resolver and integrator
auctionStartDate
* number
Unix timestamp in milliseconds
auctionDuration
* number
Unix timestamp in milliseconds
initialRateBump
* number
Initial rate bump
positiveSurplus
* string
shows if user received more than expected
isNativeCurrency
* boolean
Indicates if the taker asset is the native currency
version
* string (Enum)
Version of settlement contract. Supported: 2.0 and 2.1
2.0
2.1
2.2
cancelable
* boolean
Is order cancelable
JSON
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
{
  "orderHash": "0x496755a88564d8ded6759dff0252d3e6c3ef1fe42b4fa1bbc3f03bd2674f1078",
  "maker": "0x995BE1CA945174D5bA75410C1E658a41eB13a2FA",
  "status": "pending",
  "order": {
    "salt": "string",
    "maker": "0x995BE1CA945174D5bA75410C1E658a41eB13a2FA",
    "receiver": "0x995BE1CA945174D5bA75410C1E658a41eB13a2FA",
    "makerAsset": "0x995BE1CA945174D5bA75410C1E658a41eB13a2FA",
    "takerAsset": "0x995BE1CA945174D5bA75410C1E658a41eB13a2FA",
    "makingAmount": "100000000000000000",
    "takingAmount": "100000000000000000",
    "makerTraits": "string"
  },
  "extension": null,
  "points": [
    {
      "delay": 234,
      "coefficient": 200
    }
  ],
  "approximateTakingAmount": "100000000000000000",
  "fills": [
    {
      "txHash": "0x806039f5149065924ad52de616b50abff488c986716d052e9c160887bc09e559",
      "filledMakerAmount": "100000000000000000",
      "filledAuctionTakerAmount": "100000000000000000",
      "takerFeeAmount": "123123"
    }
  ],
  "auctionStartDate": 123123123123,
  "auctionDuration": 123123123123,
  "initialRateBump": 1000,
  "positiveSurplus": "1000",
  "isNativeCurrency": true,
  "version": "2.0",
  "cancelable": true
}

Did you find what you need?