Include a limit order to the 1inch limit orders database

You can send your limit orders to the 1inch database and then your order will participate in the 1inch aggregation protocol.

POSThttps://api.1inch.com/orderbook/v4.1/{chain}
Supported on:
EthereumBaseBNB ChainOptimismPolygonLineaSonicUnichainArbitrumAvalancheZKsyncGnosis

Parameters

chain
* number path

Request Body

LimitOrderV4Request object
orderHash
* string
Hash of the limit order typed data
signature
* string
Signature of the limit order typed data (using signTypedData_v4)
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
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
const axios = require('axios');

async function httpCall() {
  const url = 'https://api.1inch.com/orderbook/v4.1/{chain}';

  const config = {
    headers: {
      Authorization: `Bearer ${API_KEY}`,
    },
    params: {},
    paramsSerializer: {
      indexes: null,
    },
  };
  const body = {
    orderHash: 'string',
    signature: 'string',
    data: {
      makerAsset: 'string',
      takerAsset: 'string',
      maker: 'string',
      receiver: '0x0000000000000000000000000000000000000000',
      makingAmount: 'string',
      takingAmount: 'string',
      salt: 'string',
      extension: '0x',
      makerTraits: '0',
    },
  };

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

Returns

201
400
403
LimitOrderV4Response object
success
* boolean
JSON
1
2
3
4
{
  "success": false
}

Did you find what you need?