Get orders by maker address

GEThttps://api.1inch.com/fusion-plus/orders/v1.2/order/maker/{address}
Supported on:
EthereumBaseSolanaBNB ChainZKsyncGnosisOptimismPolygonLineaSonicUnichainArbitrumAvalanche

Parameters

address
* string path
Maker's address
page
number query
Pagination step, default: 1 (page = offset / limit)
limit
number query
Number of active orders to receive (default: 100, max: 500)
orderVersion
array query
Filter by order version(s). If not specified, returns orders of all versions.
timestampFrom
number query
timestampFrom in milliseconds for interval [timestampFrom, timestampTo)
timestampTo
number query
timestampTo in milliseconds for interval [timestampFrom, timestampTo)
srcToken
string query
Find history by the given source token
dstToken
string query
Find history by the given destination token
withToken
string query
Find history items by source or destination token
dstChainId
number query
Destination chain of cross chain
srcChainId
number query
Source chain of cross chain
chainId
number query
chainId for looking by dstChainId == chainId OR srcChainId == chainId

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
31
32
33
34
35
36
const axios = require('axios');

async function httpCall() {
  const url =
    'https://api.1inch.com/fusion-plus/orders/v1.2/order/maker/{address}';

  const config = {
    headers: {
      Authorization: `Bearer ${API_KEY}`,
    },
    params: {
      page: 1,
      limit: 100,
      timestampFrom: 1780794027684,
      timestampTo: 1780794027684,
      srcToken: '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2',
      dstToken: '0xc2132d05d31c914a87c6611c10748aeb04b58e8f',
      withToken: '0xc2132d05d31c914a87c6611c10748aeb04b58e8f',
      dstChainId: 137,
      srcChainId: 1,
      chainId: 56,
    },
    paramsSerializer: {
      indexes: null,
    },
  };
  const body = {};

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

Returns

default
GetOrderByMakerV1_2Output object
Paginated response containing orders by maker (v1.2)
meta
*Meta object
Pagination metadata
totalItems
* number
Total number of items
itemsPerPage
* number
Number of items per page
totalPages
* number
Total number of pages
currentPage
* number
Current page number
items
* array
List of orders by maker
items
OrderFillsByMakerOutput object
Order fills by maker output
createdAt
* number
Unix timestamp in milliseconds
order
* any
Detailed structure of the limit order according to the FusionOrderV4 specification.
oneOf[0]
CrossChainOrderDto object
Cross-chain order structure following the FusionOrderV4 specification
salt
* string
Some unique value. It is necessary to be able to create cross chain orders with the same parameters (so that they have a different hash), Lowest 160 bits of the order salt must be equal to the lowest 160 bits of the extension hash
maker
* string
Address of the account creating the order (maker) in src chain.
receiver
* string
Address of the account receiving the assets (receiver), if different from maker in dst chain.
makerAsset
* string
Identifier of the asset being offered by the maker in src chain.
takerAsset
* string
Identifier of the asset being requested by the maker in exchange in dst chain.
makingAmount
* string
Amount of the makerAsset being offered by the maker in src chain.
takingAmount
* string
Amount of the takerAsset being requested by the maker in dst chain.
makerTraits
* string
Includes some flags like, allow multiple fills, is partial fill allowed or not, price improvement, nonce, deadline etc.
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
receiver
* string
Actual receiver receiving the assets.
createTxSignature
string
Creation tx signature, only available for Solana.
positiveSurplus
* string
shows if user received more than expected
orderHash
* string
Order hash
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
status
* string (Enum)
Order status
pending
executed
expired
cancelled
refunding
refunded
unpublished
makerAsset
* string
Identifier of the asset being offered by the maker in src chain.
makerAmount
* string
Amount of the makerAsset being offered by the maker in src chain.
minTakerAmount
* string
Amount of the takerAsset being requested by the maker in dst chain.
approximateTakingAmount
* string
Approximate amount of the takerAsset being requested by the maker in dst chain.
takerAsset
* string
Identifier of the asset being requested by the maker in exchange in dst chain.
cancelTx
* string
Cancel transaction hash if order was cancelled
fills
* array
Array of fills for this order
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
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
auctionStartDate
* number
Unix timestamp in milliseconds
auctionDuration
* number
Unix timestamp in milliseconds
initialRateBump
* number
Initial rate bump
srcChainId
* number (Enum)
Identifier of the chain where the maker asset is located.
1
45
137
10
56
42161
43114
100
250
1313161554
8217
324
8453
59144
501
146
130
dstChainId
* number (Enum)
Identifier of the chain where the taker asset is located.
1
45
137
10
56
42161
43114
100
250
1313161554
8217
324
8453
59144
501
146
130
cancelable
* boolean
Is order cancelable
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
51
52
53
54
55
56
57
58
59
60
{
  "meta": {
    "totalItems": 0,
    "itemsPerPage": 0,
    "totalPages": 0,
    "currentPage": 0
  },
  "items": [
    {
      "createdAt": 123123123123,
      "order": null,
      "receiver": "0x995BE1CA945174D5bA75410C1E658a41eB13a2FA",
      "createTxSignature": "2ZhvLmmktqgQvn2e4AK8ryjGK8zJVTKiigjcNptYzP7J7A81uupjSLJFV1uMwinUfFZxpLB8UKPqQyY6P6dJR6He",
      "positiveSurplus": "1000",
      "orderHash": "0x806039f5149065924ad52de616b50abff488c986716d052e9c160887bc09e559",
      "validation": "valid",
      "status": "pending",
      "makerAsset": "0x1234567890abcdef1234567890abcdef12345678",
      "makerAmount": "1000000000000000000",
      "minTakerAmount": "100000000000000000",
      "approximateTakingAmount": "100000000000000000",
      "takerAsset": "0x1234567890abcdef1234567890abcdef12345678",
      "cancelTx": "string",
      "fills": [
        {
          "status": "pending",
          "txHash": "0x806039f5149065924ad52de616b50abff488c986716d052e9c160887bc09e559",
          "filledMakerAmount": "100000000000000000",
          "filledAuctionTakerAmount": "100000000000000000",
          "takerFeeAmount": "string",
          "escrowEvents": [
            {
              "transactionHash": "0x806039f5149065924ad52de616b50abff488c986716d052e9c160887bc09e559",
              "escrow": "string",
              "side": "src",
              "action": "src_escrow_created",
              "blockTimestamp": 123123123123
            }
          ]
        }
      ],
      "points": [
        {
          "delay": 234,
          "coefficient": 200
        }
      ],
      "auctionStartDate": 123123123123,
      "auctionDuration": 123123123123,
      "initialRateBump": 1000,
      "srcChainId": 1,
      "dstChainId": 56,
      "cancelable": true,
      "timeLocks": "0xfc000000840000000c000001bc00000144000000a800000024",
      "maker": "0x995BE1CA945174D5bA75410C1E658a41eB13a2FA",
      "version": "1.2"
    }
  ]
}

Did you find what you need?