Get orders by maker address

Retrieves paginated order history for a specific maker address. Supports filtering by tokens and time range. Stored orders that can no longer be reconstructed by the current SDK are omitted from items, so items.length can be less than meta.totalItems.

GEThttps://api.1inch.com/fusion/orders/v2.0/{chain}/order/maker/{address}
Supported on:
EthereumBaseSolanaBNB ChainCronosZKsyncGnosisHyperEVMArcMonadOptimismPolygonLineaSonicUnichainRobinhood ChainArbitrumAvalanche

Parameters

chain
* number path
address
* string path
Ethereum address of the order maker (42 character hex string with 0x prefix)
page
integer query
Page number for pagination (1-based index). Maximum value is 10
limit
integer query
Maximum number of orders to return per page
timestampFrom
number query
Start of time range filter in milliseconds (Unix timestamp). Must be less than timestampTo if both are provided
timestampTo
number query
End of time range filter in milliseconds (Unix timestamp). Must be greater than timestampFrom if both are provided
version
string (Enum)query
Filter by settlement extension version. Supported values: 2.0 or 2.1. Omit to retrieve all versions
timeSortingDirection
string (Enum)query
Sort orders by creation time. Supported values: asc, desc. Default: desc
withToken
string query
Filter orders where the token appears as either maker or taker asset. Cannot be used with makerToken or takerToken
takerToken
string query
Filter orders by the token being bought (taker asset). Must be a valid Ethereum address
makerToken
string query
Filter orders by the token being sold (maker asset). Must be a valid Ethereum address

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
25
26
27
28
29
30
const axios = require('axios');

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

  const config = {
    headers: {
      Authorization: `Bearer ${API_KEY}`,
    },
    params: {
      timestampFrom: 1791488892808,
      timestampTo: 1791488892808,
      withToken: '0xc2132d05d31c914a87c6611c10748aeb04b58e8f',
      takerToken: '0xc2132d05d31c914a87c6611c10748aeb04b58e8f',
      makerToken: '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2',
    },
    paramsSerializer: {
      indexes: null,
    },
  };

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

Returns

OrderFillsByMakerOutput object
Order details by maker with fill history, auction parameters, and execution metadata
receiver
* string
Receiver address, it can be zero address or maker address.
maker
* string
Real maker address (extracted from signature for native orders)
orderHash
* string
Order hash
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
makerAsset
* string
Identifier of the asset being offered by the maker.
makerAmount
* string
Amount of the makerAsset being offered by the maker.
minTakerAmount
* string
Amount of the takerAsset being requested by the maker.
approximateTakingAmount
* string
Approximate amount of the takerAsset being requested by the maker.
positiveSurplus
* string
shows if user received more than expected
takerAsset
* string
Identifier of the asset being requested by the maker in exchange.
cancelTx
* string
Transaction hash of order cancellation, if cancelled
fills
* array
Array of fill transactions for this order
items
FillOutputDto object
Order fill transaction details with amounts and fees
txHash
* string
Transaction hash
filledMakerAmount
* string
Amount of the makerAsset filled.
filledAuctionTakerAmount
* string
Amount of the takerAsset filled.
takerFeeAmount
* string
Total taker fee, including resolver and integrator
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
auctionStartDate
* number
Unix timestamp in milliseconds
auctionDuration
* number
Unix timestamp in milliseconds
initialRateBump
* number
Initial rate bump
isNativeCurrency
* boolean
Is native currency or no
version
* string (Enum)
Version of settlement contract. Supported: 2.0 and 2.1
2.0
2.1
2.2
makerTraits
* string
Encoded maker traits including flags for partial fills, multiple fills, deadlines, etc.
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.
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
42
43
44
45
{
  "receiver": "string",
  "maker": "0x995BE1CA945174D5bA75410C1E658a41eB13a2FA",
  "orderHash": "0x806039f5149065924ad52de616b50abff488c986716d052e9c160887bc09e559",
  "status": "pending",
  "makerAsset": "0x1234567890abcdef1234567890abcdef12345678",
  "makerAmount": "1000000000000000000",
  "minTakerAmount": "100000000000000000",
  "approximateTakingAmount": "100000000000000000",
  "positiveSurplus": "1000",
  "takerAsset": "0x1234567890abcdef1234567890abcdef12345678",
  "cancelTx": "0xa2768a9826b2c45a6937010ce21a91b1da9f8c7aa5194f68aa99306b22518b41",
  "fills": [
    {
      "txHash": "0x806039f5149065924ad52de616b50abff488c986716d052e9c160887bc09e559",
      "filledMakerAmount": "100000000000000000",
      "filledAuctionTakerAmount": "100000000000000000",
      "takerFeeAmount": "123123"
    }
  ],
  "points": [
    {
      "delay": 234,
      "coefficient": 200
    }
  ],
  "auctionStartDate": 123123123123,
  "auctionDuration": 123123123123,
  "initialRateBump": 1000,
  "isNativeCurrency": true,
  "version": "2.0",
  "makerTraits": "string",
  "order": {
    "salt": "string",
    "maker": "0x995BE1CA945174D5bA75410C1E658a41eB13a2FA",
    "receiver": "0x995BE1CA945174D5bA75410C1E658a41eB13a2FA",
    "makerAsset": "0x995BE1CA945174D5bA75410C1E658a41eB13a2FA",
    "takerAsset": "0x995BE1CA945174D5bA75410C1E658a41eB13a2FA",
    "makingAmount": "100000000000000000",
    "takingAmount": "100000000000000000",
    "makerTraits": "string"
  },
  "cancelable": true
}

Did you find what you need?