> For the complete documentation index, see [llms.txt](https://dexhunter.gitbook.io/dexhunter-partners/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dexhunter.gitbook.io/dexhunter-partners/api-reference/api.md).

# Overview

The DexHunter API lets you integrate Cardano's most powerful DEX aggregator into your application. Build swaps, limit orders, and DCA schedules with optimal routing across 15+ DEXes.

{% hint style="warning" %}
**Authentication Required**

All API requests must include the `X-Partner-Id` header with your API key.

Get your API key at [app.dexhunter.io/partners](https://app.dexhunter.io/partners) → Dashboard Tab
{% endhint %}

***

## Base URLs

| Service    | URL                              |
| ---------- | -------------------------------- |
| Main API   | `https://api-us.dexhunterv3.app` |
| Charts API | `https://charts.dhapi.io`        |

***

## Authentication

Include this header on every request:

```javascript
const headers = {
  'X-Partner-Id': 'YOUR_API_KEY',
};
```

***

## Endpoints

### 📈 Trading

Build and execute orders with smart routing.

| Endpoint                    | Description                         |
| --------------------------- | ----------------------------------- |
| `POST /swap/build`          | Build market swap transaction       |
| `POST /swap/estimate`       | Get swap quote without building tx  |
| `POST /swap/limit/build`    | Build limit order transaction       |
| `POST /swap/limit/estimate` | Get limit quote without building tx |
| `POST /dca/create`          | Build DCA order transaction         |

### 📋 Orders

Fetch, filter, and manage orders.

| Endpoint                   | Description                   |
| -------------------------- | ----------------------------- |
| `POST /swap/orders/{addr}` | Get orders for a user address |
| `POST /swap/ordersByPair`  | Get orders for a trading pair |
| `POST /swap/cancel`        | Cancel single order           |
| `POST /swap/bulkcancel`    | Cancel multiple orders        |

### 📊 Data

Token discovery and market data.

| Endpoint                          | Description                   |
| --------------------------------- | ----------------------------- |
| `GET /swap/adaValue`              | Get ADA price in USD          |
| `GET /swap/averagePrice/ADA/{id}` | Get token price in ADA        |
| `GET /stats/pools/ADA/{id}`       | Get liquidity pools           |
| `GET /stats/pairs/{id}`           | Get trading pairs             |
| `GET /stats/daily_stats/ADA/{id}` | Get 24h trading stats         |
| `GET /swap/tokens`                | Search tokens by name/ticker  |
| `GET /swap/token/{id}`            | Get token metadata            |
| `POST /charts`                    | Get OHLCV candlestick data    |
| `POST /trending`                  | Get trending tokens by volume |

***

## Transaction Flow

All trading endpoints follow the same build → sign → submit pattern:

```
1. Build   →  POST to endpoint  →  get CBOR transaction
2. Sign    →  wallet.signTx(cbor, true)  →  get signatures
3. Witness →  POST /swap/sign  →  get signed CBOR
4. Submit  →  wallet.submitTx(signedCbor)  →  get tx hash
```

```javascript
const headers = { 'X-Partner-Id': 'YOUR_API_KEY' };

// 1. Build the transaction
const { data: swap } = await axios.post(
  'https://api-us.dexhunterv3.app/swap/build',
  payload,
  { headers }
);

// 2. Sign with wallet
const signatures = await wallet.signTx(swap.cbor, true);

// 3. Add witness
const { data: signed } = await axios.post(
  'https://api-us.dexhunterv3.app/swap/sign',
  { txCbor: swap.cbor, signatures },
  { headers }
);

// 4. Submit to blockchain
const txHash = await wallet.submitTx(signed.cbor);
```