Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/fuseio/fuse-docs/llms.txt

Use this file to discover all available pages before exploring further.

The Trade API provides endpoints for integrating token price data and swap functionality into your application. It is powered by Voltage Finance, the primary DEX on Fuse Network. The API is split into two versions: V1 provides historical price and price-change data, while V2 provides real-time indicative prices, firm swap quotes, and liquidity source discovery for executing token swaps.

​
Base URL

https://api.fuse.io

​
Authentication

All requests require a public API key passed as a query parameter: 
?apiKey=YOUR_PUBLIC_API_KEY
Get your API key from the Fuse Console.

​
V1 Endpoints

​
GET /api/v0/trade/price/

Returns the latest price for a token.
​
apiKey
string
required
Your public API key.
​
tokenAddress
string
required
Token contract address to get the price for.

​
Example

curl "https://api.fuse.io/api/v0/trade/price/0xTokenAddress?apiKey=YOUR_API_KEY"

​
GET /api/v0/trade/pricechange/

Returns the price change for a token over the last 24 hours.
​
apiKey
string
required
Your public API key.
​
tokenAddress
string
required
Token contract address.

​
Example

curl "https://api.fuse.io/api/v0/trade/pricechange/0xTokenAddress?apiKey=YOUR_API_KEY"

​
POST /api/v0/trade/pricechange/

Returns the price change over a custom time duration specified in the request body.
​
apiKey
string
required
Your public API key.
​
tokenAddress
string
required
Token contract address.
​
duration
object
required
Duration object specifying the timeframe for the price change calculation.

​
Example

curl -X POST "https://api.fuse.io/api/v0/trade/pricechange/0xTokenAddress?apiKey=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"duration": {"days": 7}}'

​
GET /api/v0/trade/pricechange/interval//

Returns the price change for a token over a standard interval.
​
apiKey
string
required
Your public API key.
​
timeFrame
string
required
Interval for the price change. Allowed values: ALL, MONTH, WEEK, DAY, HOUR.
​
tokenAddress
string
required
Token contract address.

​
Example

curl "https://api.fuse.io/api/v0/trade/pricechange/interval/DAY/0xTokenAddress?apiKey=YOUR_API_KEY"

​
GET /api/v0/trade/stats/

Returns historical price statistics for a token.
​
apiKey
string
required
Your public API key.
​
tokenAddress
string
required
Token contract address.
​
limit
integer
Number of historical data points to return.

​
Example

curl "https://api.fuse.io/api/v0/trade/stats/0xTokenAddress?apiKey=YOUR_API_KEY&limit=30"

​
V2 Endpoints

​
GET /api/v1/trade/price

Returns an indicative price for a token swap. This is a non-binding quote suitable for displaying estimated prices to users before they commit to a transaction.
​
apiKey
string
required
Your public API key.
​
sellToken
string
required
The ERC20 token contract address of the token you want to sell.
​
buyToken
string
required
The ERC20 token contract address of the token you want to receive.
​
sellAmount
string
The amount of sellToken to sell, in base units (before decimals). Either sellAmount or buyAmount must be provided.
​
buyAmount
string
The amount of buyToken to receive, in base units. Either sellAmount or buyAmount must be provided.
​
slippagePercentage
string
Maximum acceptable slippage as a decimal fraction (e.g., 0.01 for 1%).
​
gasPrice
string
Target gas price for the swap transaction in wei.
​
takerAddress
string
The address that will fill the quote. Used for validation.
​
excludedSources
string
Comma-separated list of liquidity sources to exclude.
​
includedSources
string
Comma-separated list of liquidity sources to include.
​
skipValidation
boolean
When true, skips on-chain validation of the quote. Default: false.
​
feeRecipient
string
Address that should receive affiliate fees.
​
buyTokenPercentageFee
string
Percentage of the buyAmount attributed as an affiliate fee (e.g., 0.01 for 1%).
​
enableSlippageProtection
boolean
Enable slippage protection. Default: true.
​
priceImpactProtectionPercentage
string
Maximum acceptable price impact as a decimal fraction.
​
feeRecipientTradeSurplus
string
Address that receives any trade surplus fee.

​
Example

curl "https://api.fuse.io/api/v1/trade/price?apiKey=YOUR_API_KEY&sellToken=0xSellToken&buyToken=0xBuyToken&sellAmount=1000000000000000000"

​
GET /api/v1/trade/quote

Returns a firm quote for buying or selling an ERC20 token. Unlike /price, a quote includes the calldata needed to submit the swap transaction on-chain. Accepts all the same parameters as GET /api/v1/trade/price, plus:
​
apiKey
string
required
Your public API key.
​
sellToken
string
required
Token contract address of the token to sell.
​
buyToken
string
required
Token contract address of the token to receive.
​
sellAmount
string
Sell amount in base units. Provide either sellAmount or buyAmount.
​
buyAmount
string
Buy amount in base units.
​
takerAddress
string
The address that will submit the swap transaction. Required for on-chain validation.
​
shouldSellEntireBalance
boolean
When true, sells the entire available sellToken balance of the takerAddress.

​
Example

curl "https://api.fuse.io/api/v1/trade/quote?apiKey=YOUR_API_KEY&sellToken=0xSellToken&buyToken=0xBuyToken&sellAmount=1000000000000000000&takerAddress=0xYourAddress"

​
GET /api/v1/trade/sources

Returns the list of liquidity sources enabled for Fuse Network. Use the source names in excludedSources or includedSources parameters of the price and quote endpoints.
​
apiKey
string
required
Your public API key.

​
Example

curl "https://api.fuse.io/api/v1/trade/sources?apiKey=YOUR_API_KEY"

​
Error responses

StatusMeaning
400Bad Request — invalid or missing parameters
401Unauthorized — missing or invalid API key

Build docs developers (and LLMs) love

Get started for freeTalk to us