> For the complete documentation index, see [llms.txt](https://docs.kyberswap.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kyberswap.com/developer-guide/limit-order-api/api-reference/general-api.md).

# General API

General endpoints for querying supported pairs and contract addresses.

## General

### Get Supported Pairs

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

Returns all token pairs for which active limit orders exist on the specified chain.

## Get Chain Supported Pairs

> Returns the token pairs that currently have at least one active (open or partially filled) order on the chain. Please refer to \[Supported Exchanges And Networks]\(<https://docs.kyberswap.com/getting-started/supported-exchanges-and-networks>) for full list of supported networks.\
> \
> \*\*Snapshot vs delta.\*\*\
> \- Without \`lastUpdatedAt\` (or with \`lastUpdatedAt=0\`) the response is a full snapshot of all active pairs. Snapshots are served from a shared cache and may lag real time by a few seconds.\
> \- With \`lastUpdatedAt > 0\` the response is a delta since that cutoff, read directly from the database:\
> &#x20; \- \`pairs\`: pairs that have an active order created or modified after the cutoff, plus pairs that had an order deactivated after the cutoff but still have another active order.\
> &#x20; \- \`deletedPairs\`: pairs that had an order deactivated (filled, cancelled or expired) after the cutoff and have no active order left. Remove these from your local copy.\
> \
> Deltas are not paginated; both lists are complete for the requested window.\
> \
> \*\*Recommended polling pattern:\*\* fetch one snapshot, then poll deltas. For each delta, set \`lastUpdatedAt\` to the start time of your previous request (unix seconds) minus a few seconds of overlap. The cutoff is exclusive and has one-second granularity.\
> \
> \*\*Maximum delta age:\*\* a \`lastUpdatedAt\` older than about 7 days is rejected with HTTP 400, code \`4001\`, \`errorEntities: \["lastUpdatedAt"]\`. Do not retry the same cutoff: fetch a full snapshot (omit \`lastUpdatedAt\`) and resume deltas from it.

```json
{"openapi":"3.0.3","info":{"title":"KyberSwap Limit Order APIs","version":"1.3.0"},"servers":[{"url":"https://limit-order.kyberswap.com"}],"paths":{"/read-partner/api/v1/orders/pairs":{"get":{"summary":"Get Chain Supported Pairs","tags":["General"],"operationId":"get-read-partner-api-v1-orders-pairs","description":"Returns the token pairs that currently have at least one active (open or partially filled) order on the chain. Please refer to [Supported Exchanges And Networks](https://docs.kyberswap.com/getting-started/supported-exchanges-and-networks) for full list of supported networks.\n\n**Snapshot vs delta.**\n- Without `lastUpdatedAt` (or with `lastUpdatedAt=0`) the response is a full snapshot of all active pairs. Snapshots are served from a shared cache and may lag real time by a few seconds.\n- With `lastUpdatedAt > 0` the response is a delta since that cutoff, read directly from the database:\n  - `pairs`: pairs that have an active order created or modified after the cutoff, plus pairs that had an order deactivated after the cutoff but still have another active order.\n  - `deletedPairs`: pairs that had an order deactivated (filled, cancelled or expired) after the cutoff and have no active order left. Remove these from your local copy.\n\nDeltas are not paginated; both lists are complete for the requested window.\n\n**Recommended polling pattern:** fetch one snapshot, then poll deltas. For each delta, set `lastUpdatedAt` to the start time of your previous request (unix seconds) minus a few seconds of overlap. The cutoff is exclusive and has one-second granularity.\n\n**Maximum delta age:** a `lastUpdatedAt` older than about 7 days is rejected with HTTP 400, code `4001`, `errorEntities: [\"lastUpdatedAt\"]`. Do not retry the same cutoff: fetch a full snapshot (omit `lastUpdatedAt`) and resume deltas from it.","parameters":[{"schema":{"type":"string"},"in":"query","name":"chainId","description":"The chainId of the network to query.","required":true},{"schema":{"type":"integer","format":"int64","minimum":0},"in":"query","name":"lastUpdatedAt","required":false,"description":"Optional delta cutoff as a unix timestamp in **seconds** (not milliseconds). Only changes with an update time strictly greater than this value are returned, as `pairs` and `deletedPairs`. Omit it, or pass `0`, for a full snapshot.\n\nWarning: a millisecond value is not rejected. It lies in the future, so the response is silently empty.\n\nNegative values return 400/`4002`; non-integer values return 400/`4003`; values older than about 7 days return 400/`4001`."},{"schema":{"type":"boolean","default":false},"in":"query","name":"hasDistinctContractAddress","required":false,"description":"When `true`, pairs are distinguished per limit order contract, i.e. keyed by (`makerAsset`, `takerAsset`, `contractAddress`), and each item includes `contractAddress`. When `false` (default), a pair is listed once regardless of contract."}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","required":["code","message","data"],"properties":{"code":{"type":"integer","description":"The response code."},"message":{"type":"string","description":"Server response message."},"data":{"type":"object","required":["pairs"],"properties":{"pairs":{"type":"array","description":"The supported token pairs. In a delta response (`lastUpdatedAt > 0`), these are the pairs that changed since the cutoff and are still active.","items":{"$ref":"#/components/schemas/OrderPair"}},"deletedPairs":{"type":"array","description":"Present only in delta responses (`lastUpdatedAt > 0`), and omitted when empty. These pairs had an order deactivated after the cutoff and no longer have any active order. Remove them from your local copy.","items":{"$ref":"#/components/schemas/OrderPair"}}}}}}}}},"400":{"description":"Bad Request\n- `4000`: Missing required field (`chainId`)\n- `4001`: chainId is not supported\n- `4001`: `lastUpdatedAt` is older than the history a delta can cover (about 7 days). Fetch a full snapshot and resume deltas from it.\n- `4002`: `lastUpdatedAt` is negative\n- `4003`: `lastUpdatedAt` or `hasDistinctContractAddress` has an invalid format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"schemas":{"OrderPair":{"title":"OrderPair","type":"object","required":["makerAsset","takerAsset"],"properties":{"makerAsset":{"type":"string","description":"The token address of the asset which the Maker is selling."},"takerAsset":{"type":"string","description":"The token address of the asset which the Maker expects in return."},"contractAddress":{"type":"string","description":"The limit order contract address. Only present when `hasDistinctContractAddress=true`."}}},"ErrorResponse":{"title":"ErrorResponse","type":"object","properties":{"code":{"type":"integer","description":"Error code. See the error code table in the API description."},"message":{"type":"string","description":"Error message"},"errorEntities":{"type":"array","description":"The fields or entities the error refers to.","items":{"type":"string"}},"details":{"type":"array","description":"Additional error details. Includes an object with the `requestId` of the call, useful when reporting issues.","items":{"type":"object","properties":{"requestId":{"type":"string"}}}}},"required":["code","message","errorEntities"]}}}}
```

***

### Get Contract Address

`GET /read-ks/api/v1/configs/contract-address`

Returns the deployed Limit Order contract addresses for a given chain ID.

## Get Limit Order Contract Addresses

> Please refer to \[Supported Exchanges And Networks]\(<https://docs.kyberswap.com/getting-started/supported-exchanges-and-networks>) for full list of supported networks.

```json
{"openapi":"3.0.3","info":{"title":"KyberSwap Limit Order APIs","version":"1.3.0"},"servers":[{"url":"https://limit-order.kyberswap.com"}],"paths":{"/read-ks/api/v1/configs/contract-address":{"get":{"summary":"Get Limit Order Contract Addresses","tags":["General"],"operationId":"get-read-ks-api-v1-configs-contract-address","description":"Please refer to [Supported Exchanges And Networks](https://docs.kyberswap.com/getting-started/supported-exchanges-and-networks) for full list of supported networks.","parameters":[{"schema":{"type":"string"},"in":"query","name":"chainId","description":"The chainId of the network to query.","required":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","required":["code","message","data"],"properties":{"code":{"type":"integer","description":"The response code."},"message":{"type":"string","description":"Server response message."},"data":{"type":"object","required":["latest","features"],"properties":{"latest":{"type":"string","description":"The latest limit order contract address."},"features":{"type":"object","description":"The limit order contract address.","additionalProperties":{"type":"object","required":["supportDoubleSignature"],"properties":{"supportDoubleSignature":{"type":"boolean","description":"Whether the contract supports gasless cancellations (i.e. double signature = maker signature + operator signature)."}}}}}}}}}}},"400":{"description":"Bad Request\n- Missing required field\n- chainId is not supported","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"schemas":{"ErrorResponse":{"title":"ErrorResponse","type":"object","properties":{"code":{"type":"integer","description":"Error code. See the error code table in the API description."},"message":{"type":"string","description":"Error message"},"errorEntities":{"type":"array","description":"The fields or entities the error refers to.","items":{"type":"string"}},"details":{"type":"array","description":"Additional error details. Includes an object with the `requestId` of the call, useful when reporting issues.","items":{"type":"object","properties":{"requestId":{"type":"string"}}}}},"required":["code","message","errorEntities"]}}}}
```

{% hint style="info" %}
The full return object is defined in the OpenAPI YAML. GitBook has limited support for `additionalProperties`, so refer to the YAML directly for the complete schema.
{% endhint %}

For a static list of deployed addresses, see [Contracts & Addresses.](https://docs.kyberswap.com/developer-guide/limit-order-api/contracts-and-addresses.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.kyberswap.com/developer-guide/limit-order-api/api-reference/general-api.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
