Advanced Features

W Swap LP Price API

This document describes the W Swap LP Value API endpoint that returns the latest token price and LP (Liquidity Provider) token price in USD for a specific trading pair.

This document describes the W Swap LP Value API endpoint that returns the latest token price and LP (Liquidity Provider) token price in USD for a specific trading pair.

Endpoint

  • Method: GET
  • Path: /api/w-swap/lp-value/:id

Purpose

  • Returns the latest price of the pair.
  • Returns the estimated USD value of one LP token for the pair.
  • Also returns the pair name for convenience.

Request

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

Example

GET /api/w-swap/lp-value/2

Success Response

  • Status: 200 OK
  • Body:
{
  "latestPrice": 1.2345,
  "lpPriceInUsd": 0.5678,
  "pair": "USDT/WCO"
}

Field Details

  • latestPrice (number): The latest exchange rate of the pair (token1 per token0 or vice versa depending on pair configuration).
  • lpPriceInUsd (number): The estimated value of 1 LP token in USD.
  • pair (string): The human-readable pair name from trade_pairs.name.

Error Responses

  • 400 Bad Request: Missing id path parameter.
{
  "statusCode": 400,
  "statusMessage": "Missing id parameter"
}
  • 404 Not Found: Price or pair not found (no matching trade_pairs.id or missing price data).
{
  "statusCode": 404,
  "statusMessage": "Price not found"
}

Supported Trade Pairs

The following trade pairs are supported by this API. Use the corresponding ID in the request URL.

IDPair Name
1WAVE/WCO
2USDT/WCO
3USDC/WCO
4SOL/WCO
5DOGE/WCO
6XRP/WCO

Implementation Notes

  • The endpoint fetches the latest price and pair name in a single query for efficiency.
  • Results are cached for 60 seconds (maxAge: 60, swr: true) to reduce database load and improve response times.
  • Authentication is not required for this public endpoint.
  • GET /api/w-swap/volume/:id — returns the last 24 hours of traded volume (in USD).