# Developer Guides

The guides in the following section are targeted at application developers as well as smart contract integrators that are interested in building on top of the KyberSwap Aggregator ecosystem.

## Overview

To cater for varying integration complexities, KyberSwap Aggregator offers developers 2 options for integration:

* [**KyberSwap Widget**](https://docs.kyberswap.com/developer-guide/aggregator-api/how-to-guides/kyberswap-widget): An endlessly customizable widget that can be seamlessly integrated with a few lines of code. Refer to [Integrating The KyberSwap Widget](https://docs.kyberswap.com/developer-guide/aggregator-api/how-to-guides/kyberswap-widget/integrating-the-kyberswap-widget) for instructions on how to install and add the widget to your frontend.
* [**Aggregator API**](https://docs.kyberswap.com/developer-guide/aggregator-api/aggregator-api-specification): For developers that require more fine-tuned control when integrating swap functionality within their app. If you're just getting started with the KyberSwap Aggregator, you can refer to our [Execute A Swap With The Aggregator API](https://docs.kyberswap.com/developer-guide/aggregator-api/how-to-guides/execute-a-swap-with-the-aggregator-api) dev guide for information and code samples on how to query and execute swaps at the favourable rates.

{% hint style="info" %}
**KyberSwap Aggregator APIv1 Upgrades**

The [EVM swap](https://docs.kyberswap.com/developer-guide/aggregator-api/aggregator-api-specification/evm-swaps) API has been upgraded for more performant queries and the details behind the enhancement as well as the updated swap flows can be viewed on [Upgrading To APIv1](https://docs.kyberswap.com/developer-guide/aggregator-api/how-to-guides/execute-a-swap-with-the-aggregator-api/upgrading-to-apiv1).
{% endhint %}

KyberSwap Aggregator implements a router contract which handles the complexity of routing and executing swaps atomically. Please refer to [Aggregator Contract Addresses](https://docs.kyberswap.com/kyberswap-solutions/kyberswap-aggregator/broken-reference) for the full list of contracts which have been deployed across the supported chains.

## Next steps

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th data-hidden></th><th data-hidden></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><a href="../../developer-guide/aggregator-api/how-to-guides/execute-a-swap-with-the-aggregator-api"><strong>Execute A Swap With The Aggregator API</strong></a></td><td></td><td></td><td><a href="../../developer-guide/aggregator-api/how-to-guides/execute-a-swap-with-the-aggregator-api">execute-a-swap-with-the-aggregator-api</a></td></tr><tr><td><a href="https://github.com/KyberNetwork/kyberswap-documentation/blob/main/kyberswap-solutions/kyberswap-aggregator/developer-guides/broken-reference/README.md"><strong>Plug And Play The KyberSwap Widget</strong></a></td><td></td><td></td><td><a href="https://github.com/KyberNetwork/kyberswap-documentation/blob/main/kyberswap-solutions/kyberswap-aggregator/developer-guides/broken-reference/README.md">https://github.com/KyberNetwork/kyberswap-documentation/blob/main/kyberswap-solutions/kyberswap-aggregator/developer-guides/broken-reference/README.md</a></td></tr><tr><td><a href="../../developer-guide/aggregator-api/how-to-guides/kyberswap-widget/customizing-the-kyberswap-widget"><strong>Customize The KyberSwap Widget</strong></a></td><td></td><td></td><td><a href="../../developer-guide/aggregator-api/how-to-guides/kyberswap-widget/customizing-the-kyberswap-widget">customizing-the-kyberswap-widget</a></td></tr><tr><td><a href="https://github.com/KyberNetwork/kyberswap-documentation/blob/main/kyberswap-solutions/kyberswap-aggregator/developer-guides/broken-reference/README.md"><strong>More Performant Queries With APIv2</strong></a></td><td></td><td></td><td><a href="https://github.com/KyberNetwork/kyberswap-documentation/blob/main/kyberswap-solutions/kyberswap-aggregator/developer-guides/broken-reference/README.md">https://github.com/KyberNetwork/kyberswap-documentation/blob/main/kyberswap-solutions/kyberswap-aggregator/developer-guides/broken-reference/README.md</a></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.kyberswap.com/kyberswap-solutions/kyberswap-aggregator/developer-guides.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.