Skip to main content

​
Pricing Data API

The Pricing Data API gives you live market data (price, market cap, 24h volume, 24h high/low, and 24h change) for a list of assets in a single request. It is designed for partners who today read these fields from CoinGecko’s /coins/markets endpoint and want a single managed source from Renesis instead. The request and the response use the same asset identifiers and the same field names as CoinGecko, so swapping the data source is a one-line change: point the request at Renesis, keep your existing field mapping.
Renesis supplies the market data layer only (the live price, market cap, and volume figures). Your own scoring and metadata (grade, type of backing, type of peg, collateralization, audits, team) stay exactly where they are. This endpoint replaces the part currently labelled “Data provided by CoinGecko”.

​
How it maps to your table

Each row in your stablecoin table maps directly to fields in the response:
Your columnCoinGecko field todayRenesis response field
Pricecurrent_pricecurrent_price
Market Capmarket_capmarket_cap
24h Volumetotal_volumetotal_volume
24h change (%)price_change_percentage_24hprice_change_percentage_24h
Peg deviationderived from current_pricecurrent_price, high_24h, low_24h
For a fiat-pegged stablecoin, the peg deviation is simply current_price - 1 (in USD). high_24h and low_24h give you the intraday peg band.

​
Base URL

https://api.renesis.fi
All paths below are relative to this base URL.

​
Authentication

Every request authenticates with a Renesis API key (prefix ak_) passed in the X-API-Key header. Your key is issued to your account; keep it secret and server-side. 
curl -H "X-API-Key: ak_test_xxxxxxxxxxxxxxxxxxxx" \
  "https://api.renesis.fi/data/market-data/multiple-tickers?vs_currency=usd&symbols=usd-coin,tether"
The key is scoped to a set of allowed paths and roles when provisioned. For this integration it needs access to /data/** with one of the roles admin, trader, pms_user, or analyst; a read-only pricing key is sufficient. Contact your Renesis representative to provision a key.

​
Asset identifiers (coin IDs)

The symbols parameter takes CoinGecko-style coin IDs (the lowercase slug), not exchange tickers. For example you pass usd-coin, not USDC, and pax-gold, not PAXG. This matches the IDs you already use against CoinGecko, so your existing ID list carries over unchanged. Common stablecoins and their coin IDs:
AssetTickerCoin ID
TetherUSDTtether
USD CoinUSDCusd-coin
Ripple USDRLUSDripple-usd
PayPal USDPYUSDpaypal-usd
Pax GoldPAXGpax-gold
Gemini DollarGUSDgemini-dollar
Pax DollarUSDPpaxos-standard
Euro CoinEURCeuro-coin
Liquity USDLUSDliquity-usd
First Digital USDFDUSDfirst-digital-usd
DaiDAIdai
Ethena USDeUSDeethena-usde
If an asset is missing from this table, its coin ID is the slug in its CoinGecko page URL (coingecko.com/en/coins/<id>). IDs are stable over time, so you only need to look one up when you add a new asset to your watchlist.

​
Get prices for multiple assets

Returns market data for every requested asset in one call. This is the endpoint you poll to populate your table. 
GET /data/market-data/multiple-tickers
​
vs_currency
string
required
Quote currency for all returned figures, lowercase (e.g. usd, eur). Use usd for USD-pegged stablecoins and for commodity-backed tokens like PAXG.
​
symbols
string
required
Comma-separated list of coin IDs (e.g. usd-coin,tether,paypal-usd). Case-insensitive and whitespace-tolerant. Send your full watchlist in a single request.

​
Example request

# Pull the full stablecoin watchlist in one call
curl -H "X-API-Key: ak_test_xxxxxxxxxxxxxxxxxxxx" \
  "https://api.renesis.fi/data/market-data/multiple-tickers?vs_currency=usd&symbols=ripple-usd,usd-coin,paypal-usd,pax-gold"

​
Example response

data is an array, one object per resolved asset, in no guaranteed order. Index it by id on your side. 
{
  "isError": false,
  "message": "Success",
  "statusCode": 200,
  "data": [
    {
      "id": "ripple-usd",
      "symbol": "rlusd",
      "name": "Ripple USD",
      "image": "https://coin-images.coingecko.com/coins/images/.../rlusd.png",
      "current_price": 0.999776,
      "market_cap": 1681918852,
      "market_cap_rank": 38,
      "fully_diluted_valuation": 1681918852,
      "total_volume": 137916372,
      "high_24h": 1.001,
      "low_24h": 0.9988,
      "price_change_24h": -0.000112,
      "price_change_percentage_24h": -0.0112,
      "market_cap_change_24h": -1820145,
      "market_cap_change_percentage_24h": -0.108,
      "circulating_supply": 1682295410,
      "total_supply": 1682295410,
      "max_supply": null,
      "ath": 1.02,
      "ath_change_percentage": -2.01,
      "ath_date": "2025-01-14T09:20:11.000Z",
      "atl": 0.984,
      "atl_change_percentage": 1.6,
      "atl_date": "2025-03-04T22:05:40.000Z",
      "last_updated": "2026-06-09T12:30:00.000Z",
      "vs_currency": "usd",
      "fetched_at": "2026-06-09T12:31:05.123456+00:00",
      "source": "fresh"
    },
    {
      "id": "usd-coin",
      "symbol": "usdc",
      "name": "USDC",
      "current_price": 0.9997,
      "market_cap": 76023145200,
      "market_cap_rank": 6,
      "total_volume": 15610247889,
      "high_24h": 1.001,
      "low_24h": 0.9991,
      "price_change_percentage_24h": -0.0145,
      "circulating_supply": 76045231100,
      "vs_currency": "usd",
      "fetched_at": "2026-06-09T12:31:05.123456+00:00",
      "source": "cached"
    },
    {
      "id": "pax-gold",
      "symbol": "paxg",
      "name": "PAX Gold",
      "current_price": 4319.96,
      "market_cap": 1990114502,
      "market_cap_rank": 41,
      "total_volume": 159204881,
      "high_24h": 4332.10,
      "low_24h": 4298.55,
      "price_change_percentage_24h": 0.42,
      "circulating_supply": 460678.2,
      "vs_currency": "usd",
      "fetched_at": "2026-06-09T12:31:05.123456+00:00",
      "source": "fresh"
    }
  ]
}

​
Response fields

Each object in data carries the standard CoinGecko markets fields plus three Renesis fields (vs_currency, fetched_at, source). The fields you are most likely to display:
FieldTypeDescription
idstringCoin ID you requested. Use this as the join key.
symbolstringLowercase ticker (e.g. usdc).
namestringDisplay name (e.g. USDC).
current_pricenumberPrice in vs_currency. Full precision for peg monitoring.
market_capnumberMarket capitalisation in vs_currency.
total_volumenumber24h trading volume in vs_currency.
high_24hnumberHighest price in the last 24h.
low_24hnumberLowest price in the last 24h.
price_change_24hnumberAbsolute price change over 24h.
price_change_percentage_24hnumberPercent price change over 24h.
market_cap_change_24hnumberAbsolute market cap change over 24h.
market_cap_change_percentage_24hnumberPercent market cap change over 24h.
circulating_supplynumberCirculating supply.
total_supplynumberTotal supply (may be null).
max_supplynumberMax supply (often null for stablecoins).
ath / atlnumberAll-time high / low, with *_change_percentage and *_date.
last_updatedstringISO 8601 timestamp from the upstream feed.
vs_currencystringQuote currency the figures are denominated in.
fetched_atstringISO 8601 timestamp of when Renesis captured the data.
sourcestringFreshness indicator: fresh, cached, or stale. See below.
Field coverage follows the upstream markets feed. Numeric fields can be null when the upstream source has no value for that asset (common for total_supply / max_supply on some stablecoins). Guard for null before formatting.

​
Data freshness and caching

Renesis maintains a warm cache so you can poll aggressively without hitting upstream rate limits. The source field on every asset tells you where that specific value came from:
sourceMeaning
freshJust fetched live from the upstream feed on this request.
cachedServed from the warm cache (refreshed within the last 15 minutes).
staleA fallback: the upstream feed was momentarily rate-limited, so the last known good value was returned. Still usable; just older than 15 minutes.
A single response can mix sources across assets. The cache TTL is 15 minutes, so polling more frequently than that mostly returns cached values and is served instantly. For a live table, polling every 30 to 60 seconds is a good balance.

​
Get price for a single asset

Same data as above for one asset. data is a single object rather than an array. 
GET /data/market-data/single-ticker
​
vs_currency
string
required
Quote currency, lowercase (e.g. usd).
​
symbol
string
required
A single coin ID (e.g. ripple-usd).
curl -H "X-API-Key: ak_test_xxxxxxxxxxxxxxxxxxxx" \
  "https://api.renesis.fi/data/market-data/single-ticker?vs_currency=usd&symbol=ripple-usd"

{
  "isError": false,
  "message": "Success",
  "statusCode": 200,
  "data": {
    "id": "ripple-usd",
    "symbol": "rlusd",
    "name": "Ripple USD",
    "current_price": 0.999776,
    "market_cap": 1681918852,
    "total_volume": 137916372,
    "vs_currency": "usd",
    "fetched_at": "2026-06-09T12:31:05.123456+00:00",
    "source": "fresh"
  }
}
For a watchlist, prefer /multiple-tickers: one request for the whole basket is faster and friendlier on rate limits than many single-ticker calls.

​
Error responses

Errors follow the standard envelope, with isError: true and a human-readable message.

​
Missing parameters (400)

{
  "isError": true,
  "message": "vs_currency and symbols are required.",
  "statusCode": 400
}

​
Unauthorized (401)

Returned when the X-API-Key header is missing or the key is invalid or revoked. 
{
  "isError": true,
  "message": "Unauthorized - Invalid or missing API key.",
  "statusCode": 401
}

​
Forbidden (403)

Returned when the key is valid but not scoped for this resource (missing /data path access or lacking one of the roles admin, trader, pms_user, analyst). 
{
  "isError": true,
  "message": "Forbidden - Insufficient permissions.",
  "statusCode": 403
}

​
Asset not found (404)

Returned by /single-ticker when the coin ID cannot be priced. On /multiple-tickers, unknown IDs are simply omitted from the data array rather than failing the whole request, so always check which IDs came back. 
{
  "isError": true,
  "message": "Price not found",
  "statusCode": 404
}
A simple, robust loop for a live stablecoin table:
  1. Collect IDs once. For each asset on your watchlist, take its coin ID from the table above (or the CoinGecko page URL) and store it. IDs rarely change, so this is a one-time (or on-add) step.
  2. Poll the basket. On your refresh interval (30 to 60 seconds is plenty), call /multiple-tickers with vs_currency=usd and your full comma-separated ID list. One request covers the whole table.
  3. Join by id. Map each returned object onto your row by id. Read current_price into Price, market_cap into Market Cap, total_volume into 24h Volume.
  4. Handle gaps. If an ID is missing from data, keep the last known value and flag it. If source is stale, the value is older than 15 minutes but still safe to display.
  5. Keep your own metadata. Grade, type of backing, type of peg, collateralization, and audits remain yours; only the live market figures come from this API.