Get all limit orders with cursor pagination

Retrieves all limit orders with cursor-based pagination. Supports dynamic sorting by different fields.

GEThttps://api.1inch.com/orderbook/v4.1/{chain}/all
Supported on:
EthereumBaseBNB ChainLineaSonicUnichainArbitrumAvalancheZKsyncGnosisOptimismPolygon

Parameters

chain
* number path
limit
integer query
Number of limit orders to receive (default: 100, max: 500)
statuses
string query
A comma-separated list of statuses by which limit orders will be filtered. Valid statuses include: 1 - Valid orders, 2 - Temporarily invalid orders, 3 - Invalid orders.
sortBy
string (Enum)query
Field to sort by (determines cursor fields)
makerAsset
string query
Address of the maker asset
takerAsset
string query
Address of the taker asset
cursor
string query
base64 representation of the cursor

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/orderbook/v4.1/{chain}/all';

  const config = {
    headers: {
      Authorization: `Bearer ${API_KEY}`,
    },
    params: {
      statuses: '1,2,3',
      makerAsset: '0x1234567890ABCDEF1234567890ABCDEF12345678',
      takerAsset: '0x1234567890ABCDEF1234567890ABCDEF12345678',
      cursor:
        'eyJjcmVhdGVEYXRlVGltZSI6IjIwMjUtMDEtMThUMTQ6MjM6MzAuODIyWiIsIm9yZGVySGFzaCI6IjB4NDk4NmRiZmM4NTFkZDE2OTYzOTU0MzA2YTY3YjAwMjdiN2QzYTgwODY5NTMxMTQ3ZjBhZWQ4NWZiZmVkZmJjIn0',
    },
    paramsSerializer: {
      indexes: null,
    },
  };
  const body = {};

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

Returns

200
400
GetAllLimitOrdersV4_1PaginatedResponse object
meta
* any
Cursor pagination metadata
allOf[0]
CursorMeta object
hasMore
* boolean
Whether there are more items available
nextCursor
string
Next cursor for pagination
count
number
Total count of items (if available)
items
* array
Array of limit orders
items
GetAllLimitOrdersV4Response object
orderHash
* string
Hash of the limit order typed data
signature
* string
Signature of the limit order typed data (using signTypedData_v4)
createDateTime
* string
The date and time of order creation
remainingMakerAmount
* string
The remaining amount for the maker
makerBalance
* string
The balance of the maker
makerAllowance
* string
The allowance granted to the maker
data
* any
Limit order data
allOf[0]
LimitOrderV4Data object
makerAsset
* string
Address of the maker asset
takerAsset
* string
Address of the taker asset
maker
* string
An address of the maker (wallet or contract address)
receiver
string
An address of the wallet or contract who will receive filled amount (equals to Zero address for receiver == makerAddress)
makingAmount
* string
Order maker's token amount
takingAmount
* string
Order taker's token amount
salt
* string
Some unique value. It is necessary to be able to create limit 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
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
makerTraits
string
Includes some flags like, allow multiple fills, is partial fill allowed or not, price improvement, nonce, deadline etc
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
{
  "meta": {
    "hasMore": true,
    "nextCursor": "eyJhY3Rpdml0eURhdGUiOiIyMDIzLTEwLTE5VDE0OjAzOjI3LjUwMFoiLCJvcmRlckhhc2giOiIweDBkOTIwNzllMzgyOGYxZGQ2ZTQ4MTI2OWUwZDkxMmU2MGQwNGE1OGEwM2EyYzFmMDUyOWVkMTIwY2U2YmEwYmMifQ==",
    "count": 150
  },
  "items": [
    {
      "orderHash": "string",
      "signature": "string",
      "createDateTime": "2023-10-19T14:03:27.500Z",
      "remainingMakerAmount": "70000000000",
      "makerBalance": "0",
      "makerAllowance": "115792089237316195423570985008687907853269984665640564039457584007913129639935",
      "data": {
        "makerAsset": "string",
        "takerAsset": "string",
        "maker": "string",
        "receiver": "0x0000000000000000000000000000000000000000",
        "makingAmount": "string",
        "takingAmount": "string",
        "salt": "string",
        "extension": "0x",
        "makerTraits": "0"
      }
    }
  ]
}

Did you find what you need?