Get orders by hashes (v1.2 with fee support)

Returns orders with fills including takerFeeAmount field for fee-enabled orders.

POSThttps://api.1inch.com/fusion-plus/orders/v1.2/order/status
Supported on:
EthereumBaseSolanaBNB ChainZKsyncGnosisOptimismPolygonLineaSonicUnichainArbitrumAvalanche

Parameters

This request doesn’t have any parameters.

Request Body

OrdersByHashesInput object
Input for querying multiple orders by their hashes
orderHashes
* array
Array of order hashes to query
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-plus/orders/v1.2/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

default
GetOrderFillsByHashV1_2Output object
Order fills response with detailed fill information (v1.2)
orderHash
* string
Order hash
receiver
* string
Actual receiver receiving the assets.
createTxSignature
string
Creation tx signature, only available for Solana.
status
* string (Enum)
Order status
pending
executed
expired
cancelled
refunding
refunded
unpublished
validation
* string (Enum)
Order validation status
valid
order-predicate-returned-false
not-enough-balance
not-enough-allowance
invalid-permit-signature
invalid-permit-spender
invalid-permit-signer
invalid-signature
failed-to-parse-permit-details
unknown-permit-version
wrong-epoch-manager-and-bit-invalidator
failed-to-decode-remaining
unknown-failure
order
* any
Order data
oneOf[0]
LimitOrderV4StructOutput object
Limit order V4 structure output
salt
* string
Order salt value
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
Maker traits encoded as hex string
oneOf[1]
SolanaOrderOutput object
Solana order output
orderInfo
*OrderInfoDto object
Order information for Solana cross-chain orders
srcToken
* string
Src token account
dstToken
* string
Dst token account
maker
* string
Maker in src chain
srcAmount
* string
Making amount
minDstAmount
* string
Taking amount on dst chain
receiver
* string
Receiver on dst chain
escrowParams
*EscrowParamsDto object
Escrow parameters for cross-chain order execution
hashLock
* string
Hash lock for the escrow
srcChainId
* number
Source chain id (Solana = 501)
dstChainId
* number
Destination chain id, any EVM compatible supported chain
srcSafetyDeposit
* string
Safety deposit amount on src chain
dstSafetyDeposit
* string
Safety deposit amount on dst chain
timeLocks
* string
Encoded timelocks for escrow operations
details
*Details object
Order details containing auction data
auction
* any
Auction configuration
allOf[0]
AuctionData object
Auction configuration data including timing and price curve
startTime
* string
Auction start time
duration
* string
Auction duration
initialRateBump
* number
Coefficient of distance between points
points
* array
Auction price curve points
items
AuctionPoint object
Single point in the auction price curve
delay
* number
Delay in seconds from auction start
coefficient
* number
Price coefficient at this point
extra
*ExtraData object
Extra data for the order
srcAssetIsNative
* boolean
Is the swapped src asset native or not
orderExpirationDelay
* string
expirationTime - startTime - duration
resolverCancellationConfig
*ResolverCancellationConfig object
Configuration for resolver cancellation auction
maxCancellationPremium
* string
Maximum cancellation premium amount
cancellationAuctionDuration
* number
Cancellation auction duration in seconds
allowMultipleFills
* boolean
If multiple fills allowed or no
salt
* string
Random salt value
extension
string
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.Only available in evm orders
points
* array
Auction points for the order
items
AuctionPointOutput object
Single point in the auction price curve
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.
positiveSurplus
* string
shows if user received more than expected
fills
* array
Fills
items
FillOutputDto object
Fill event data for an order
status
* string (Enum)
Fill status
pending
executed
refunding
refunded
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.
escrowEvents
* array
Array of escrow events related to this fill
items
EscrowEventDataOutput object
Escrow event data containing transaction and action details
transactionHash
* string
Transaction hash
escrow
* string
The address of the escrow where the action happened
side
* string (Enum)
Side of the escrow event SRC or DST
src
dst
action
* string (Enum)
Action of the escrow event
src_escrow_created
dst_escrow_created
withdrawn
funds_rescued
escrow_cancelled
blockTimestamp
* number
Unix timestamp in milliseconds
auctionStartDate
* number
Unix timestamp in seconds
auctionDuration
* number
in seconds
initialRateBump
* number
Initial rate bump
createdAt
* number
Unix timestamp in milliseconds
srcTokenPriceUsd
* string
Source token price in USD
dstTokenPriceUsd
* string
Destination token price in USD
cancelTx
* string
Cancel transaction hash if order was cancelled
srcChainId
* number
Identifier of the chain where the maker asset is located.
dstChainId
* number
Identifier of the chain where the taker asset is located.
cancelable
* boolean
Is order cancelable
takerAsset
* string
Identifier of the asset being requested by the maker in exchange in dst chain.
timeLocks
* string
TimeLocks without deployedAt
maker
* string
Real maker address (Solana or EVM format)
version
* string (Enum)
Order version
1.1
1.2
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
42
43
44
45
46
47
48
49
50
{
  "orderHash": "0x496755a88564d8ded6759dff0252d3e6c3ef1fe42b4fa1bbc3f03bd2674f1078",
  "receiver": "0x995BE1CA945174D5bA75410C1E658a41eB13a2FA",
  "createTxSignature": "2ZhvLmmktqgQvn2e4AK8ryjGK8zJVTKiigjcNptYzP7J7A81uupjSLJFV1uMwinUfFZxpLB8UKPqQyY6P6dJR6He",
  "status": "pending",
  "validation": "valid",
  "order": null,
  "extension": "string",
  "points": [
    {
      "delay": 234,
      "coefficient": 200
    }
  ],
  "approximateTakingAmount": "100000000000000000",
  "positiveSurplus": "1000",
  "fills": [
    {
      "status": "pending",
      "txHash": "0x806039f5149065924ad52de616b50abff488c986716d052e9c160887bc09e559",
      "filledMakerAmount": "100000000000000000",
      "filledAuctionTakerAmount": "100000000000000000",
      "takerFeeAmount": "string",
      "escrowEvents": [
        {
          "transactionHash": "0x806039f5149065924ad52de616b50abff488c986716d052e9c160887bc09e559",
          "escrow": "string",
          "side": "src",
          "action": "src_escrow_created",
          "blockTimestamp": 123123123123
        }
      ]
    }
  ],
  "auctionStartDate": 123123123123,
  "auctionDuration": 123123123123,
  "initialRateBump": 1000,
  "createdAt": 123123123123,
  "srcTokenPriceUsd": "string",
  "dstTokenPriceUsd": "string",
  "cancelTx": "string",
  "srcChainId": 1,
  "dstChainId": 501,
  "cancelable": true,
  "takerAsset": "0x995BE1CA945174D5bA75410C1E658a41eB13a2FD",
  "timeLocks": "0xfc000000840000000c000001bc00000144000000a800000024",
  "maker": "0x995BE1CA945174D5bA75410C1E658a41eB13a2FA",
  "version": "1.2"
}

Did you find what you need?