---
title: "Get Orders By Token Pair"
method: GET
path: "/read-partner/api/v1/orders"
tags: ["Taker"]
---

# Get Orders By Token Pair

`GET /read-partner/api/v1/orders`

Returns orders for the queried token pair sorted by best rates in descending order.

## Query parameters

- `chainId` string, required
- `makerAsset` string, required
- `takerAsset` string, required

## Response `200`

OK

- object
  - `code` integer, required — The response code.
  - `message` string, required — Server response message.
  - `data` object, required
    - `orders` object[], required
      - `id` integer, required — The limit order ID.
      - `chainId` string, required — The chainId on which the order was created.
      - `signature` string, required — The signed EIP712 message which created the Maker order.
      - `salt` string, required — The randomized data fed as an additional input to the create order function.
      - `makerAsset` string, required — The token address of the asset which the Taker expects in return.
      - `takerAsset` string, required — The token address of the asset which the Taker is exchanging.
      - `maker` string, required — The address of the Maker.
      - `contractAddress` string, required — The address of the Limit Order contract.
      - `receiver` string, required — The address of the Taker to receive the `makerAsset`.
      - `allowedSenders` string, required — Defines the addresses who are allowed to fill the order.
      - `makingAmount` string, required — The amount of `makerAsset` in wei. String representation of uint256 value.
      - `takingAmount` string, required — The amount of `takerAsset` in wei. String representation of uint256 value.
      - `filledMakingAmount` string, required — The amount of `makerAsset` which has been filled for this order.
      - `filledTakingAmount` string, required — The amount of `takerAsset` which has been filled for this order.
      - `feeConfig` string, required — The hashstring representing the fee configuration for the order.
      - `feeRecipient` string, required — The address to receive the fees, if any. Fees are configured in `makerTokenFeePercent`.
      - `makerTokenFeePercent` string, required — Amount of makerToken paid by the taker to the `feeRecipient`. For example, 20% = 0.2 -> makerTokenFeePercent = 0.2 * 10000 = 2000 Format: uint32
      - `makerAssetData` string, required — ABIv2 encoded data that can be decoded by a specified proxy contract when transferring makerAsset.
      - `takerAssetData` string, required — ABIv2 encoded data that can be decoded by a specified proxy contract when transferring takerAsset.
      - `getMakerAmount` string, required — The hexstring representing the `makerAsset` amount.
      - `getTakerAmount` string, required — The hexstring representing the `takerAsset` amount.
      - `predicate` string, required — Call data that indicates the validity of the orders logic.
      - `permit` string, required — Included data if token is able to leverage Permit function (EIP2612) for gasless approvals.
      - `interaction` string, required — Call data that is sent to an intermediate contract when the order is filled.
      - `expiredAt` integer, required — The unix timestamp upon which the Maker order will automatically lapse (i.e. expire).
      - `availableMakingAmount` string, required — The remaining makingAmount available to be filled
      - `makerBalanceAllowance` string, required — The smaller value between maker's balance for makerAsset and maker's allowance for DSLO contract to spend makerAsset

## Other responses

- `400` — Bad Request - Missing required fields
- `500` — Internal Server Error - Error when get price from Price Service

---

[API](https://skmtc.net/kyberswap/apis/zap-service.md) · [All operations](https://skmtc.net/kyberswap/apis/zap-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kyberswap/zap-service/revisions/74dbd81c8d70/schema)