# API Documentation

Use this API to integrate Hypertrade R1 on HyperEVM.

Base URL: <https://api.ht.xyz/api/v1>

Router Contract Address: 0xe4609ab5f4c268c42ba470fbcbb9b9abf895f1a5

### Find route

```
POST /simulation
```

Finds the optimal routing path for swap execution and simulates the complete route. Returns the full routing path, expected output amount for the user, and the raw transaction data.

#### Request Body

```
{
  "inputAmount": "1",
  "slippage": 0.3,
  "userAddress": "0x...",
  "inputTokenAddress": "0x...",
  "outputTokenAddress": "0x...",
  "feeAddress": "0x...",
  "recipientAddress": "0x...",
  "feeBps": 100
}
```

#### Parameters:

| inputAmount        | string  | Raw input token amount in atomic units (value × 10^decimals). | yes      |
| ------------------ | ------- | ------------------------------------------------------------- | -------- |
| slippage           | number  | Maximum slippage tolerance.                                   | yes      |
| userAddress        | address | User's wallet address for the swap.                           | optional |
| inputTokenAddress  | address | Contract address of the input token.                          | yes      |
| outputTokenAddress | address | Contract address of the output token.                         | yes      |
| feeAddress         | address | Your address for receiving commissions from swaps.            | optional |
| recipientAddress   | address | Address for sending output tokens post-swap.                  | optional |
| feeBps             | number  | Your commission in basis points (100 = 1%). Max: 100.         | optional |

#### Successful Response (200 OK)

```
{
  "transaction": "0x...", // Raw-transaction for swap execution.
  "route": [
    {
      "inputTokenAddress": "0x...",
      "outputTokenAddress": "0x...",
      "splits": [
        {
          "dex": "hyperswap",
          "portion": 0.5,
          "fee": 3000,
          "poolAddress": "0x..."
        }
      ]
    }
  ],
  "outputAmount": "100000", // amount*10^decimals
  "economy": "123.45"
}
```