Get multiple orders by hashes

Retrieves detailed information for multiple orders in a single request. Returns an array of order details matching the provided hashes.

POSThttps://api.1inch.com/fusion/orders/v2.0/{chain}/order/status
Supported on:
EthereumBaseSolanaBNB ChainUnichainArbitrumAvalancheZKsyncGnosisOptimismPolygonLineaSonic

Parameters

chain
* number path

Request Body

OrdersByHashesInput object
Request body for retrieving multiple orders by their hashes
orderHashes
* array
Array of order hashes to retrieve
items
string
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
const axios = require('axios');

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

  const config = {
    headers: {
      Authorization: `Bearer ${API_KEY}`,
    },
    params: {},
    paramsSerializer: {
      indexes: null,
    },
  };
  const body = {
    orderHashes: [
      '0x10ea5bd12b2d04566e175de24c2df41a058bf16df4af3eb2fb9bff38a9da98e9',
      '0x20ea5bd12b2d04566e175de24c2df41a058bf16df4af3eb2fb9bff38a9da98e8',
      '0x30ea5bd12b2d04566e175de24c2df41a058bf16df4af3eb2fb9bff38a9da98e7',
      '0x40ea5bd12b2d04566e175de24c2df41a058bf16df4af3eb2fb9bff38a9da98e6',
    ],
  };

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

Returns

200
400
500
array
items
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
40
41
[
  {
    "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?