# Arken Swap Engine API

API Endpoint: `https://public-api.arken.finance`

{% hint style="info" %}
Please refer to [Arken API](https://docs.arken.ag/for-developers/arken-api) for getting API tokens
{% endhint %}

Using Arken Finance Swap Engine API, you can find the best route to exchange assets and make the swap.\
\
Here are the step-by-step instructions on how to use Arken Swap Engine API:

1. Find the addresses of the tokens you want to swap. For example, swapping WETH -> USDT
   1. WETH: `0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2`
   2. USDT: `0xdac17f958d2ee523a2206206994597c13d831ec7`
2. Check for allowance of Arken Approve contract to spend source asset using `/approve/allowance`
3. If necessary, give approval for Arken Approve contract to spend the source token using `/approve/transaction`
4. Monitor the best exchange route using `/swap/quote`
5. When you are ready to swap, use `/swap/swap` to generate the call data to perform the swap

### Chains

{% openapi src="<https://api.arken.finance/docs/public/swap-engine-api.openapi.json>" path="/swap-engine/v1/chains" method="get" %}
<https://api.arken.finance/docs/public/swap-engine-api.openapi.json>
{% endopenapi %}

### Health Check

{% openapi src="<https://api.arken.finance/docs/public/swap-engine-api.openapi.json>" path="/swap-engine/v1/{chainID}/healthcheck" method="get" %}
<https://api.arken.finance/docs/public/swap-engine-api.openapi.json>
{% endopenapi %}

### Approve

{% openapi src="<https://api.arken.finance/docs/public/swap-engine-api.openapi.json>" path="/swap-engine/v1/{chainID}/approve/spender" method="get" %}
<https://api.arken.finance/docs/public/swap-engine-api.openapi.json>
{% endopenapi %}

{% openapi src="<https://api.arken.finance/docs/public/swap-engine-api.openapi.json>" path="/swap-engine/v1/{chainID}/approve/transaction" method="get" %}
<https://api.arken.finance/docs/public/swap-engine-api.openapi.json>
{% endopenapi %}

{% openapi src="<https://api.arken.finance/docs/public/swap-engine-api.openapi.json>" path="/swap-engine/v1/{chainID}/approve/allowance" method="get" %}
<https://api.arken.finance/docs/public/swap-engine-api.openapi.json>
{% endopenapi %}

### Info

{% openapi src="<https://api.arken.finance/docs/public/swap-engine-api.openapi.json>" path="/swap-engine/v1/{chainID}/liquidity-sources" method="get" %}
<https://api.arken.finance/docs/public/swap-engine-api.openapi.json>
{% endopenapi %}

### Swap

{% openapi src="<https://api.arken.finance/docs/public/swap-engine-api.openapi.json>" path="/swap-engine/v1/{chainID}/swap/quote" method="get" %}
<https://api.arken.finance/docs/public/swap-engine-api.openapi.json>
{% endopenapi %}

{% openapi src="<https://api.arken.finance/docs/public/swap-engine-api.openapi.json>" path="/swap-engine/v1/{chainID}/swap/swap" method="get" %}
<https://api.arken.finance/docs/public/swap-engine-api.openapi.json>
{% endopenapi %}
