GET /price/:symbol

Real-time aggregated price from all supported DEXes.

Cost: $0.01 USDC

Parameters

Path Parameters

Parameter	Type	Required	Description
symbol	string	Yes	Token symbol (ETH, BTC, SOL, etc.)

Query Parameters

Parameter	Type	Default	Description
include_sources	boolean	true	Include per-DEX prices

Request

response = client.get("https://api.foursec.xyz/price/ETH")
data = response.json()

Response

{
  "symbol": "ETH",
  "price_usd": 2450.32,
  "change_24h": 2.45,
  "volume_24h_usd": 12500000,
  "total_sources": 3,
  "spread": 0.07,
  "timestamp": "2026-07-04T15:30:00Z",
  "sources": [
    {
      "dex": "Uniswap V3",
      "chain": "Base",
      "pair": "ETH/USDC",
      "price": 2450.30,
      "liquidity_usd": 5200000,
      "volume_24h": 4800000
    },
    {
      "dex": "BaseSwap",
      "chain": "Base",
      "pair": "ETH/USDC",
      "price": 2450.35,
      "liquidity_usd": 3100000,
      "volume_24h": 2900000
    },
    {
      "dex": "SushiSwap",
      "chain": "Base",
      "pair": "ETH/USDC",
      "price": 2450.28,
      "liquidity_usd": 4200000,
      "volume_24h": 4800000
    }
  ]
}

Response Fields

Field	Type	Description
symbol	string	Token symbol
price_usd	float	Volume-weighted average price (VWAP)
change_24h	float	24-hour price change percentage
volume_24h_usd	float	Total 24h volume across all DEXes
total_sources	int	Number of DEX sources used
spread	float	Price spread between highest and lowest DEX (%)
timestamp	string	ISO 8601 timestamp
sources	array	Individual DEX price data

Source Object

Field	Type	Description
dex	string	DEX name
chain	string	Blockchain network
pair	string	Trading pair
price	float	Price on this DEX
liquidity_usd	float	Pool liquidity in USD
volume_24h	float	24h volume on this DEX