> 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/taker-api.md).

# Taker API

## Taker

Taker endpoints cover the full fill flow: query open orders sorted by best rate, obtain the required Operator co-signature, encode the fill calldata, and execute on-chain.

For a step-by-step guide, see [Fill a Limit Order](broken://pages/hjKETw7k3CWHDxjSyhgT).

For taker protocol fees and the rate calculation formula, see [Fee Structure.](https://docs.kyberswap.com/developer-guide/limit-order-api/fee-structure.md)

***

### Get Open Orders <a href="#get-open-orders" id="get-open-orders"></a>

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

Returns open orders for a token pair sorted by best effective rate (descending). The rate accounts for partial fills and protocol fees — see Fee Structure.

## Get Orders By Token Pair

> Returns active (\`open\` and \`partially\_filled\`) orders for the queried token pair, sorted by rate (\`makingAmount / takingAmount\`) in descending order, i.e. best rate for the Taker first.\
> \
> A bounded number of best-rate orders is read, and then filtered:\
> \- Orders whose Maker is blacklisted are removed.\
> \- Private orders (non-zero \`allowedSenders\`) are removed, unless \`includePrivateOrder\` or \`includeAllowedSenders\` is set.\
> \- Orders whose Maker balance or allowance cannot cover the remaining amount are removed, unless \`includeInsufficientBalance=true\`.\
> \
> \*\*Balance allocation.\*\* \`availableMakingAmount\` is allocated greedily per Maker in rate order. A Maker's balance and allowance are consumed by that Maker's better-rate orders first, so the amounts across a Maker's orders in one response never exceed the Maker's last known balance and allowance.\
> \
> \*\*Hex fields.\*\* \`signature\`, \`getMakerAmount\`, \`getTakerAmount\`, \`predicate\`, \`interaction\`, \`orderHash\` and similar hex fields are returned \*\*without\*\* a \`0x\` prefix; an empty value means empty bytes.

```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":{"get":{"summary":"Get Orders By Token Pair","tags":["Taker"],"operationId":"get-read-partner-api-v1-orders","description":"Returns active (`open` and `partially_filled`) orders for the queried token pair, sorted by rate (`makingAmount / takingAmount`) in descending order, i.e. best rate for the Taker first.\n\nA bounded number of best-rate orders is read, and then filtered:\n- Orders whose Maker is blacklisted are removed.\n- Private orders (non-zero `allowedSenders`) are removed, unless `includePrivateOrder` or `includeAllowedSenders` is set.\n- Orders whose Maker balance or allowance cannot cover the remaining amount are removed, unless `includeInsufficientBalance=true`.\n\n**Balance allocation.** `availableMakingAmount` is allocated greedily per Maker in rate order. A Maker's balance and allowance are consumed by that Maker's better-rate orders first, so the amounts across a Maker's orders in one response never exceed the Maker's last known balance and allowance.\n\n**Hex fields.** `signature`, `getMakerAmount`, `getTakerAmount`, `predicate`, `interaction`, `orderHash` and similar hex fields are returned **without** a `0x` prefix; an empty value means empty bytes.","parameters":[{"schema":{"type":"string"},"in":"query","name":"chainId","description":"The chainId of the network to query.","required":true},{"schema":{"type":"string"},"in":"query","name":"makerAsset","description":"The token address of the asset which the Taker expects in return.","required":true},{"schema":{"type":"string"},"in":"query","name":"takerAsset","description":"The token address of the asset which the Taker is exchanging.","required":true},{"schema":{"type":"string"},"in":"query","name":"contractAddress","required":false,"description":"Optional. Only return orders created on this limit order contract."},{"schema":{"type":"boolean","default":false},"in":"query","name":"includeInsufficientBalance","required":false,"description":"When `true`, orders whose Maker balance or allowance cannot fully cover the remaining amount are included, with `availableMakingAmount` reduced to what is actually fillable."},{"schema":{"type":"boolean","default":false},"in":"query","name":"includePrivateOrder","required":false,"description":"When `true`, private orders (orders restricted to specific `allowedSenders`) are included."},{"schema":{"type":"string"},"in":"query","name":"includeAllowedSenders","required":false,"description":"Comma-separated list of **lowercase** addresses. When set, the response contains public orders plus private orders whose `allowedSenders` include one of these addresses (`includePrivateOrder` is then ignored)."}],"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":["orders"],"properties":{"orders":{"type":"array","items":{"type":"object","required":["id","chainId","signature","salt","makerAsset","takerAsset","maker","contractAddress","receiver","allowedSenders","makingAmount","takingAmount","filledMakingAmount","filledTakingAmount","feeConfig","feeRecipient","makerTokenFeePercent","makerAssetData","takerAssetData","getMakerAmount","getTakerAmount","predicate","permit","interaction","expiredAt","orderHash","isTakerAssetFee","makerAssetDecimals","takerAssetDecimals"],"properties":{"id":{"type":"integer","description":"The limit order ID."},"chainId":{"type":"string","description":"The chainId on which the order was created."},"signature":{"type":"string","description":"The Maker's EIP712 signature of the order (hex, without `0x` prefix)."},"salt":{"type":"string","description":"The randomized data fed as an additional input to the create order function."},"makerAsset":{"type":"string","description":"The token address of the asset which the Taker expects in return."},"takerAsset":{"type":"string","description":"The token address of the asset which the Taker is exchanging."},"maker":{"type":"string","description":"The address of the Maker."},"contractAddress":{"type":"string","description":"The address of the Limit Order contract."},"receiver":{"type":"string","description":"The address that receives the `takerAsset` when the order is filled (the Maker, a Maker-defined receiver, or the unwrapper contract for `nativeOutput` orders)."},"allowedSenders":{"type":"string","description":"Comma-separated addresses allowed to fill the order. `0x0000000000000000000000000000000000000000` means anyone (public order)."},"makingAmount":{"type":"string","description":"The amount of `makerAsset` in wei. String representation of uint256 value."},"takingAmount":{"type":"string","description":"The amount of `takerAsset` in wei. String representation of uint256 value."},"filledMakingAmount":{"type":"string","description":"The amount of `makerAsset` which has been filled for this order."},"filledTakingAmount":{"type":"string","description":"The amount of `takerAsset` which has been filled for this order."},"feeConfig":{"type":"string","description":"Decimal uint256 that packs the fee configuration signed into the order:\n- bit 192: `isTakerAssetFee`\n- bits 160-191: fee rate in units of 1/100000 (i.e. `makerTokenFeePercent` × 10)\n- bits 0-159: `feeRecipient` address"},"isTakerAssetFee":{"type":"boolean","description":"`true` if the fee is charged in `takerAsset` instead of `makerAsset`. Takers must account for this when computing fill amounts."},"feeRecipient":{"type":"string","description":"The address to receive the fees, if any. Fees are configured in `makerTokenFeePercent`."},"makerTokenFeePercent":{"type":"string","description":"Fee rate in basis points (1/10000) paid to the `feeRecipient`, charged in `makerAsset` or `takerAsset` per `isTakerAssetFee`. For example, 0.1% -> makerTokenFeePercent = 0.001 * 10000 = 10\nFormat: uint32"},"makerAssetData":{"type":"string","description":"ABIv2 encoded data that can be decoded by a specified proxy contract when transferring makerAsset."},"takerAssetData":{"type":"string","description":"ABIv2 encoded data that can be decoded by a specified proxy contract when transferring takerAsset."},"getMakerAmount":{"type":"string","description":"The hexstring representing the `makerAsset` amount."},"getTakerAmount":{"type":"string","description":"The hexstring representing the `takerAsset` amount."},"predicate":{"type":"string","description":"Call data that indicates the validity of the orders logic."},"permit":{"type":"string","description":"Included data if token is able to leverage Permit function (EIP2612) for gasless approvals."},"interaction":{"type":"string","description":"Call data that is sent to an intermediate contract when the order is filled."},"expiredAt":{"type":"integer","description":"The unix timestamp upon which the Maker order will automatically lapse (i.e. expire)."},"orderHash":{"type":"string","description":"The EIP712 hash of the order (hex, without `0x` prefix)."},"clientId":{"type":"string","description":"The client identifier the order was created with."},"referral":{"type":"string","description":"The referral the order was created with. Omitted when empty."},"nativeOutput":{"type":"boolean","description":"`true` if the Maker receives the native token (the order is routed through the unwrapper set as `receiver`). Omitted when `false`."},"makerAssetDecimals":{"type":"integer","description":"The number of decimals of `makerAsset`."},"takerAssetDecimals":{"type":"integer","description":"The number of decimals of `takerAsset`."},"availableMakingAmount":{"type":"string","description":"The remaining `makingAmount` that can actually be filled: the order's remaining amount, capped by the Maker's balance and allowance left after the Maker's better-rate orders in this response. Omitted when the Maker's balance information is temporarily unavailable."},"makerBalanceAllowance":{"type":"string","description":"The smaller of the Maker's `makerAsset` balance and the Maker's allowance to the order's limit order contract. Omitted when the Maker's balance information is temporarily unavailable."}}}}}}}}}}},"400":{"description":"Bad Request\n- `4000`: Missing required fields\n- `4001`: chainId is not supported\n- `4003`: makerAsset, takerAsset, contractAddress are not valid addresses; boolean flags have 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":{"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 Operator Signature <a href="#get-operator-signature" id="get-operator-signature"></a>

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

Returns the KyberSwap Operator co-signature for one or more orders. This signature is required as part of the fill calldata and is short-lived — fetch it immediately before building the fill transaction.

## Request Operator Signature For Maker Orders

> Takers will need to request for KyberSwap Operator signature for target Maker orders which they are planning to fill. The returned operator signature will be required when encoding the Taker fill order for both \`/read-ks/api/v1/encode/fill-batch-orders-to\` and \`/read-ks/api/v1/encode/fill-order-to\`.\
> \
> \*\*Lifetime.\*\* Operator signatures are short-lived (minutes). Always rely on the returned \`operatorSignatureExpiredAt\` and do not hard-code a lifetime. A signature is re-issued unchanged while enough validity remains, so repeated calls within that window return the same signature. Fill before \`operatorSignatureExpiredAt\`; a transaction mined after it reverts on-chain.\
> \
> Only active orders are signed. Order IDs that do not exist or are no longer active are silently omitted from the response; there is no 404. Request only what you are about to fill: polling this endpoint for large ID sets is discouraged.

```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/operator-signature":{"get":{"summary":"Request Operator Signature For Maker Orders","tags":["Taker"],"operationId":"post-read-partner-api-v1-orders-operator-signature","description":"Takers will need to request for KyberSwap Operator signature for target Maker orders which they are planning to fill. The returned operator signature will be required when encoding the Taker fill order for both `/read-ks/api/v1/encode/fill-batch-orders-to` and `/read-ks/api/v1/encode/fill-order-to`.\n\n**Lifetime.** Operator signatures are short-lived (minutes). Always rely on the returned `operatorSignatureExpiredAt` and do not hard-code a lifetime. A signature is re-issued unchanged while enough validity remains, so repeated calls within that window return the same signature. Fill before `operatorSignatureExpiredAt`; a transaction mined after it reverts on-chain.\n\nOnly active orders are signed. Order IDs that do not exist or are no longer active are silently omitted from the response; there is no 404. Request only what you are about to fill: polling this endpoint for large ID sets is discouraged.","parameters":[{"schema":{"type":"string"},"in":"query","name":"chainId","required":true,"description":"The chainId on which the order is being filled. Only supports EVM chains."},{"schema":{"type":"array","minItems":1,"maxItems":100,"uniqueItems":true,"items":{"type":"integer"}},"in":"query","name":"orderIds","required":true,"style":"form","explode":true,"description":"The IDs of the orders to be filled, sent as repeated query keys (e.g. `orderIds=22452&orderIds=22453`), between 1 and 100 unique IDs. A comma-separated single value is rejected (400/`4003`)."}],"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":["orders"],"properties":{"orders":{"type":"array","description":"One entry per requested order that is still active. Inactive or unknown IDs are omitted.","items":{"type":"object","required":["id","chainId","operatorSignature","operatorSignatureExpiredAt"],"properties":{"id":{"type":"integer","description":"ID of Maker order to be filled."},"chainId":{"type":"string","description":"Chain which order to be filled is on."},"operatorSignature":{"type":"string","description":"The signature of the operator for the requested order id (hex, without `0x` prefix)."},"operatorSignatureExpiredAt":{"type":"integer","description":"The unix timestamp (seconds) at which the Operator's signature expires."}}}}}}}}}}},"400":{"description":"Bad Request\n- `4000`: Missing required fields\n- `4001`: chainId is not supported\n- `4002`: orderIds is empty or has more than 100 entries\n- `4003`: orderIds has an invalid format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Conflict\n- Duplicate orderId in request","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"]}}}}
```

***

### Encode Fill Order <a href="#encode-fill-order" id="encode-fill-order"></a>

`POST /read-ks/api/v1/encode/fill-order-to`

Returns encoded calldata to fill a **single** order on-chain. The encoded data is sent as `data` in the transaction to the Limit Order contract.

| Field               | Description                                                             |
| ------------------- | ----------------------------------------------------------------------- |
| `orderId`           | The order to fill                                                       |
| `takingAmount`      | Amount of `takerAsset` to provide (can be partial)                      |
| `thresholdAmount`   | Minimum `makingAmount` to receive — reverts if not met (slippage guard) |
| `target`            | Address to receive the `makerAsset`                                     |
| `operatorSignature` | From `GET /read-partner/api/v1/orders/operator-signature`               |

## Generate Encoded Data To Fill Order

> Request for the encoded fill order data from KyberSwap. This data can then be executed on-chain from the Taker's wallet, sent to the order's \`contractAddress\`.\
> \
> The calldata embeds the order's current operator-signature expiry as stored by KyberSwap. Use a signature from \`/read-partner/api/v1/orders/operator-signature\` that has not expired, otherwise the transaction reverts.\
> \
> Also served as \`/read-partner/api/v1/encode/fill-order-to\`.

```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/encode/fill-order-to":{"post":{"summary":"Generate Encoded Data To Fill Order","tags":["Taker"],"operationId":"post-read-ks-api-v1-encode-fill-order-to","description":"Request for the encoded fill order data from KyberSwap. This data can then be executed on-chain from the Taker's wallet, sent to the order's `contractAddress`.\n\nThe calldata embeds the order's current operator-signature expiry as stored by KyberSwap. Use a signature from `/read-partner/api/v1/orders/operator-signature` that has not expired, otherwise the transaction reverts.\n\nAlso served as `/read-partner/api/v1/encode/fill-order-to`.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["orderId","takingAmount","thresholdAmount","target","operatorSignature"],"properties":{"orderId":{"type":"integer","description":"The ID of the order to be filled."},"takingAmount":{"type":"string","description":"The amount of `takerAsset` in wei. String representation of uint256 value."},"thresholdAmount":{"type":"string","description":"If thresholdAmount != 0, the order will be filled \nif and only if (actualTakingAmount / actualMakingAmount) <= (thresholdAmount / requestedMakingAmount)."},"target":{"type":"string","description":"The Taker wallet address which will receive the `makerAsset`."},"operatorSignature":{"type":"string","description":"The Operator signature obtained from `/read-partner/api/v1/orders/operator-signature` (with or without `0x` prefix). Required for orders on contracts with `supportDoubleSignature: true`; missing it returns 400/`4000` (`operatorSignature`)."}}}}}},"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":["encodedData"],"properties":{"encodedData":{"type":"string","description":"The fill order encoded data to be used as the on-chain tx call data."}}}}}}}},"400":{"description":"Bad Request\n- `4000`: Missing required fields (including `operatorSignature` for double-signature contracts)\n- `4002`: takingAmount, thresholdAmount are not uint256\n- `4003`: orderId, takingAmount, thresholdAmount have an invalid format; target is not a valid address","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found\n- `4040`: The order does not exist or is no longer active","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"]}}}}
```

***

### Encode Fill Batch Orders <a href="#encode-fill-batch-orders" id="encode-fill-batch-orders"></a>

`POST /read-ks/api/v1/encode/fill-batch-orders-to`

Returns encoded calldata to fill **multiple** orders in a single on-chain transaction. The `orderIds` array and `operatorSignatures` array must be in the same order.

## Generate Encoded Data To Fill Batch Order

> Request for the encoded fill batch order data from KyberSwap. This data can then be executed on-chain from the Taker's wallet, sent to the orders' \`contractAddress\`.\
> \
> All orders must be active, on the same chain and contract, have the same \`makerAsset\` and \`takerAsset\`, and charge the fee on the same side (\`isTakerAssetFee\`).\
> \
> Also served as \`/read-partner/api/v1/encode/fill-batch-orders-to\`.

```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/encode/fill-batch-orders-to":{"post":{"summary":"Generate Encoded Data To Fill Batch Order","tags":["Taker"],"operationId":"post-read-ks-api-v1-encode-fill-batch-orders-to","description":"Request for the encoded fill batch order data from KyberSwap. This data can then be executed on-chain from the Taker's wallet, sent to the orders' `contractAddress`.\n\nAll orders must be active, on the same chain and contract, have the same `makerAsset` and `takerAsset`, and charge the fee on the same side (`isTakerAssetFee`).\n\nAlso served as `/read-partner/api/v1/encode/fill-batch-orders-to`.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["orderIds","takingAmount","thresholdAmount","target","operatorSignatures"],"properties":{"orderIds":{"type":"array","description":"The order IDs to be filled in the batch order. Must be unique.","minItems":1,"items":{"type":"integer"}},"takingAmount":{"type":"string","description":"The amount of `takerAsset` in wei. String representation of uint256 value."},"thresholdAmount":{"type":"string","description":"If thresholdAmount != 0, the order will be filled \nif and only if (actualTakingAmount / actualMakingAmount) <= (thresholdAmount / requestedMakingAmount)."},"target":{"type":"string","description":"The Taker wallet address which will receive the `makerAsset`."},"operatorSignatures":{"type":"array","description":"The Operator signatures obtained from `/read-partner/api/v1/orders/operator-signature`, in the same order as `orderIds` (with or without `0x` prefix). For double-signature contracts it must have exactly as many entries as `orderIds` (otherwise 400/`4002`) and none may be empty (otherwise 400/`4000`).","items":{"type":"string"}}}}}}},"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":["encodedData"],"properties":{"encodedData":{"type":"string","description":"The fill batch order encoded data to be used as the on-chain tx call data."}}}}}}}},"400":{"description":"Bad Request\n- `4000`: Missing required fields (including an empty operator signature for double-signature contracts)\n- `4001`: Orders belong to different contracts (`contractAddress`) or mix maker-asset and taker-asset fees (`orderIds`)\n- `4002`: orderIds is empty; takingAmount, thresholdAmount are not uint256; `operatorSignatures` length does not match `orderIds`\n- `4003`: takingAmount, thresholdAmount have an invalid format; target is not a valid address\n- `40011`: Orders don't have the same makerAsset, takerAsset and chainId","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found\n- `4040`: An order does not exist or is no longer active","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Conflict\n- Duplicate order ids in request","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"]}}}}
```


---

# 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/taker-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.
