⛓️PulseSwap API

PulseSwap is a multi-chain DEX aggregator that finds the best swap prices across multiple liquidity sources. It scans 12+ aggregators and 50+ DEXs in real time, including PulseX, 9inch, and others. Developers can integrate PulseSwap to give users cost-efficient swaps directly inside their applications.

Supported DEXs / Aggreagators:

• PulseX (v1)

• PulseX (v2)

• Piteas

• 9inch (v2)

• 9inch (v3)

• 9mm (v2)

• 9mm (v3)

Base URL

https://quotes.pulseswap.io/api/v1

Endpoint: Get Best Quote

Returns the best available quote for a given token pair and amount, scanning all supported DEXes.

Method: POST /quotes/best

Request Body

Field	Type	Required	Description	Example
walletAddress	string	No	Ethereum-compatible wallet address	0x1234567890123456789012345678901234567890
fromToken	string	Yes	Contract address of token to swap from	0xA1077a294dDE1B09bB078844df40758a5D0f9a27
toToken	string	Yes	Contract address of token to receive	0x2b591e99afe9f32eaa6214f7b7629768c40eeb39
amountIn	string	Yes	Amount in smallest unit (string for large ints)	1000000000000000000
slippage	number	Yes	Slippage tolerance in % (e.g., 0.5)	0.5

Example Request JSON

{
  "walletAddress": "0x1234567890123456789012345678901234567890",
  "fromToken": "0xA1077a294dDE1B09bB078844df40758a5D0f9a27",
  "toToken": "0x2b591e99afe9f32eaa6214f7b7629768c40eeb39",
  "amountIn": "1000000000000000000",
  "slippage": 0.5
}

---

Response

Field	Type	Description	Example
success	boolean	Request success status	true
tokenPath	string[]	Swap route as array of token addresses	["0xA1077...", "0x2b59..."]
amountOut	string	Expected output amount (smallest unit)	1000000000
gasUseEstimate	number	Estimated gas usage	100000
tx	object	Transaction details (optional)	See below

Transaction Object:

Field	Type	Description
from	string	Sender address
to	string	Contract address to call
value	string	ETH value in wei (optional)
data	string	Encoded transaction data (optional)

Example Response JSON

{
  "success": true,
  "tokenPath": [
    "0xA1077a294dDE1B09bB078844df40758a5D0f9a27",
    "0x2b591e99afe9f32eaa6214f7b7629768c40eeb39"
  ],
  "amountOut": "1000000000000",
  "gasUseEstimate": 100000,
  "tx": {
    "from": "0x1234567890123456789012345678901234567890",
    "to": "0x641115e36eDEa30Fee041156b15585C99A8BF398",
    "value": "10000000000000000000000000",
    "data": "0x..."
  }
}

---

Example cURL

curl -X POST "https://quotes.pulseswap.io/api/v1/quotes/best" \
  -H "Content-Type: application/json" \
  -d '{
    "walletAddress": "0x1234567890123456789012345678901234567890",
    "fromToken": "0xA1077a294dDE1B09bB078844df40758a5D0f9a27",
    "toToken": "0x2b591e99afe9f32eaa6214f7b7629768c40eeb39",
    "amountIn": "1000000000000000000",
    "slippage": 0.5
  }'

---

Error Responses

400 Bad Request

{
  "statusCode": 400,
  "message": [
    "walletAddress must be an Ethereum address",
    "fromToken must be an Ethereum address",
    "toToken must be an Ethereum address",
    "amountIn should not be empty",
    "slippage should not be empty"
  ],
  "error": "Bad Request"
}

500 Internal Server Error

{
  "statusCode": 500,
  "message": "Internal server error"
}

---

Developer Notes

• All token addresses must be valid Ethereum-compatible addresses.

• Always pass amountIn as a string to avoid integer overflow.

• slippage is expressed as a percentage (0.5 = 0.5%).

• Gas estimates are approximate and may vary at execution.

• The API automatically searches all supported DEXes for the best possible rate.

• Contact/support via X @PulseCoinList