🔋W Swap Trade Volume API

This document describes the W Swap Trade Volume API endpoint that returns the last 24 hours of traded volume (in USD) for a specific trading pair.

EndpointCopy Anchor Link

• Method: GET
• URL: https://oracle.w-chain.com/api/w-swap/volume/:id

PurposeCopy Anchor Link

• Returns the 24-hour aggregated USD volume for the specified trading pair.
• Also returns the pair name for convenience.

RequestCopy Anchor Link

• Path parameter id (number): The trade_pairs.id of the pair.

ExampleCopy Anchor Link

GET https://oracle.w-chain.com/api/w-swap/volume/2

Success ResponseCopy Anchor Link

• Status: 200 OK
• Body:

{
  "vol24h": 12345.67,
  "pair": "USDT/WCO"
}

Field DetailsCopy Anchor Link

• vol24h (number): Total swap volume in USD over the past 24 hours.
• pair (string): The human-readable pair name from trade_pairs.name.

Error ResponsesCopy Anchor Link

• 400 Bad Request: Missing id path parameter.

{
  "statusCode": 400,
  "statusMessage": "Missing id parameter"
}

• 404 Not Found: Pair not found (no matching trade_pairs.id).

{
  "statusCode": 404,
  "statusMessage": "Pair not found"
}

How Volume Is CalculatedCopy Anchor Link

• Source table: trade_pair_swap_events.
• Aggregation: Sum of usd_value for rows where:
  • pair_id equals the requested id.
  • timestamp is within the last 24 hours (gt now - 24h and lte now).
• USD valuation:
  • Stablecoins (USDT, USDC, and bridged variants) use a 1:1 USD mapping.
  • WCO is valued using its CoinGecko USD price.
  • Other tokens may currently resolve to 0 USD unless specifically supported.
• Caching: Results are cached for ~60 seconds to reduce load.

trade_pairs ReferenceCopy Anchor Link

The following pairs (from trade_pairs) are relevant for W Swap operations and USD valuation logic. The usd_value_from column indicates which token is used to determine USD value during swaps: 0 means token0, 1 means token1.

Note on wave_pidCopy Anchor Link

The wave_pid sequence skips 3 because in Wave Farm, pool ID 3 is a WCO Single Stake pool (not an LP pool). Therefore, LP-related pairs continue with 4, 5, 6, etc.

Usage ExamplesCopy Anchor Link

cURLCopy Anchor Link

curl -s "http://<host>/api/w-swap/volume/2"

JavaScript (fetch)Copy Anchor Link

// Fetch 24h volume for pair id 2 (USDT/WCO)
const resp = await fetch('/api/w-swap/volume/2');
if (!resp.ok) throw new Error('Request failed');
const data = await resp.json();
// data.vol24h is a number in USD; data.pair is the pair name

Implementation NotesCopy Anchor Link

• Internals use a 60-second cache to avoid excessive DB queries.
• If there are no swap events in the last 24h for the given pair, vol24h returns 0.
• Authentication is not required for this public endpoint.

Related EndpointsCopy Anchor Link

• GET /api/w-swap/lp-value/:id — returns latest pair price and LP price (in USD).