Docs
Version 1 (v1)
Splines

Splines v1 API

Our Splines API delivers card-like images featuring almost-real-time token prices and spline price charts.

💡

Note: The free-to-use version of the Splines API is cached with a Time to Live (TTL) of 5 seconds and comes with a stale-while-revalidate period of an additional 5 seconds. For finer granularity, please Contact us.

Change since v0

  • The default market alias for usd has been updated from ousdc to usd_coingecko.
  • Additional fiat currencies have been integrated into the market query parameter.
  • The splines image now showcases the market icon alongside the token icon.

Endpoint

https://api.swapscanner.io/v1/tokens/splines/[tokenAddress].[type]
  • tokenAddress - Refers to the contract address of the token
  • type - Denotes the image format (supports png, svg)

Query Parameters

  • locale - Specifies the locale for price display (default: en-US, options: en-US, ko-KR)
  • market - Determines the base market for the price (default: usd (usd_coingecko)). Supported markets can be found under Supported Market Currencies. Alternatively, use the address of any token (e.g. 0x0000000000000000000000000000000000000000 for KLAY-based pricing).

Supported Market currencies

  • usd_coingecko - Uses the USD price of KLAY on CoinGecko.
  • usd - Equivalent to usd_coingecko.
  • ousdc - Assumes the oUSDC Token price as $1. Identical to 0x754288077d0ff82af7a5317c7cb8c444d421d103.
  • krw_bithumb - Adopts the KRW price of KLAY on Bithumb.
  • krw - Same as krw_bithumb.
  • krw_coingecko - Takes the KRW price of KLAY on CoinGecko.
  • krw_ousdc - Uses the ousdc value but in KRW (CoinGecko's KRW/USD forex rate is applied).

Response

Outputs a PNG or SVG image according to the specified request.