> For the complete documentation index, see [llms.txt](https://docs.hera.finance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hera.finance/developers/emporia-sdk/swagger-api.md).

# Swagger API

{% hint style="danger" %}
Datasets providing access to the SDK have not been updated for a long time. Please note that the SDK may not function properly until the completion of the V3 upgrade!
{% endhint %}

## Hera Dex Aggregator - Swap Protocol API

### Metis Mainnet Release

Using Hera Aggregation protocol API, you can find the best route to exchange assets and make the exchange.\
\
Progressing:

1. Lookup addresses of tokens you want to swap, for example ‘0xxx’ , ‘0xxxx’ for USDC -> METIS
2. Check for allowance and if necessary give approval for HeraAggregatorV2 contract to spend token (/allowance)
3. Monitor the best exchange route using (/quote)
4. When you ready use to perform swap (/swap)

{% hint style="info" %}
**EmporiaSDK is now available on Metis Mainnet.** Other chains are coming soon!
{% endhint %}

<details>

<summary><strong>Built with OpenAPI &#x26; Swagger!</strong></summary>

Design, describe, and document your API on the first open source editor supporting multiple API specifications and serialization formats. The Swagger Editor offers an easy way to get started with the OpenAPI Specification (formerly known as Swagger) as well as the AsyncAPI specification, with support for Swagger 2.0, OpenAPI 3.0, and AsyncAPI 2.\* versions.

</details>

### Swagger Paths:

#### Allowance&#x20;

{% openapi src="/files/lqZFMH1uPGH5AyXvwled" path="/allowance" method="get" expanded="true" %}
[EmporiaSDK-Metis-v1-1.json](https://468680357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRPd6E8y8uIj9QOgICwhl%2Fuploads%2F1Ez7x7M8GFPcrisX6sA8%2FEmporiaSDK-Metis-v1-1.json?alt=media\&token=d6b75e97-c3ed-4b3a-b311-8722b3bdc9c0)
{% endopenapi %}

{% code overflow="wrap" %}

```
// Example Query:

GET https://pathfindersdk.hera.finance/allowance?account=0x0000000000000000000000000000000000000000&amount=1000000&tokenInAddress=0xEA32A96608495e54156Ae48931A7c20f0dcc1a21
```

{% endcode %}

#### Quote (Pathfinder)

{% openapi src="/files/lqZFMH1uPGH5AyXvwled" path="/quote" method="get" expanded="true" %}
[EmporiaSDK-Metis-v1-1.json](https://468680357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRPd6E8y8uIj9QOgICwhl%2Fuploads%2F1Ez7x7M8GFPcrisX6sA8%2FEmporiaSDK-Metis-v1-1.json?alt=media\&token=d6b75e97-c3ed-4b3a-b311-8722b3bdc9c0)
{% endopenapi %}

{% code overflow="wrap" %}

```
// Example Query:

GET https://pathfindersdk.hera.finance/quote?account=0x0000000000000000000000000000000000000000&tokenInAddress=0xDeadDeAddeAddEAddeadDEaDDEAdDeaDDeAD0000&tokenInChainId=1088&tokenOutAddress=0xEA32A96608495e54156Ae48931A7c20f0dcc1a21&tokenOutChainId=1088&amount=100000000000000000000&type=exactIn
```

{% endcode %}

#### Swap

{% openapi src="/files/lqZFMH1uPGH5AyXvwled" path="/swap" method="get" expanded="true" %}
[EmporiaSDK-Metis-v1-1.json](https://468680357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRPd6E8y8uIj9QOgICwhl%2Fuploads%2F1Ez7x7M8GFPcrisX6sA8%2FEmporiaSDK-Metis-v1-1.json?alt=media\&token=d6b75e97-c3ed-4b3a-b311-8722b3bdc9c0)
{% endopenapi %}

{% code overflow="wrap" %}

```
// Example Query:

GET https://pathfindersdk.hera.finance/swap?account=0x0000000000000000000000000000000000000000&tokenInAddress=0xDeadDeAddeAddEAddeadDEaDDEAdDeaDDeAD0000&tokenInChainId=1088&tokenOutAddress=0xEA32A96608495e54156Ae48931A7c20f0dcc1a21&tokenOutChainId=1088&amount=100000000000000000000
```

{% endcode %}