---
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`

## Request

- Base URL: `https://zap-api.kyberswap.com/arbitrum`
- URL: `https://zap-api.kyberswap.com/arbitrum/read-partner/api/v1/orders`
- Auth: none declared
- TypeScript: <https://skmtc.dev/kyberswap/apis/zap-service/docs/read-partner/api/v1/orders/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/kyberswap/apis/zap-service.md) - [All operations](https://skmtc.dev/kyberswap/apis/zap-service/llms.txt) - [OpenAPI document](https://skmtc.dev/kyberswap/apis/zap-service/revisions/74dbd81c8d70?raw)