Skip to main content
Market Data add-on. Live and historical Cardano market data aggregated across all 11 Cardano DEXes: token prices, OHLCV candles, liquidity pools, order books, swap activity, NFT collection stats, dApp blueprints, and an LP leaderboard.
Endpoints on this page require the Market Data add-on, on its own or through the Data or Complete bundle. Without it they return HTTP 402 with "addon": "marketData". Available on Starter, Builder, Growth and Scale, included in Enterprise.
Base URL: https://nexus.gerowallet.io · Auth: X-Api-Key: nxs_…

Prices

Sparklines and currency rates

GET /api/prices/sparklines returns a short, downsampled series of ADA-quoted close prices for every tracked token, sized for a row chart. It takes one query parameter:
data is keyed by the same assetId that GET /api/prices/latest returns. Each series is oldest first, built from hourly candles and downsampled to at most points closes. Its first point is the close the window’s price change is measured from, so first to last has the same sign as the matching priceChange figure. GET /api/prices/currency-rate takes no parameters and returns the ADA price in USD, its price at three points in the past, and ADA quoted in other currencies:
Both responses are cached upstream, so refresh them every few minutes at most. A public partner key can also read them from a registered origin, which is how the market page draws its sparklines and currency selector.

Launchpad tokens

Some tokens start on a launchpad, snek.fun or Solada, where they trade on an off-chain bonding curve until they graduate to an on-chain liquidity pool. Price rows, in the lists above and on the WebSocket price feed, carry an optional source that says where a token came from: GET /api/market/snekfun and GET /api/market/solada list each launchpad’s tokens, those still on the bonding curve plus its graduates, as a bare array of the same price rows. Both take limit, 0 to 500 (0 returns all, capped at 500). The snek.fun list is refreshed every 60 seconds and the Solada list every 30 seconds.
A launchpad token always has verified: false, because it is not in the Cardano token registry (CIP-26). That describes its metadata, not its price. Its logo is a thumbnail URL on the market-data host (https://market.gerowallet.io/api/ipfs/thumb?path=<cid>&size=128), so load it like any other logo URL. A Solada graduate is indexed in near real time: it is listed from the block that creates its pool. The rows of GET /api/aggregator/tokens carry the same verified and source fields.

DEX

Token trades and trader attribution

GET /api/dex/swaps/token/{policyId}/{assetName} returns a token’s latest executed trades, newest first. It takes limit, 1 to 200, default 50. Each row says which wallet made the trade when Nexus can tell, how it knows, and how sure it is. When one transaction fills several orders, a row is matched only to its own trader’s orders.
One row, with its other trade fields left out. The txHash is shortened with …; the API returns the full 64-character hash. A trader or recipient object holds: What to expect:
  • Order fills through batchers (Minswap, WingRiders, Splash, ShadowBook, MuesliSwap), including orders routed by aggregators, are where attribution is strongest: the trader is the wallet that placed the order, usually with its stake address and HIGH confidence. MuesliSwap V1 orders name their owner less reliably and come back LOW.
  • SundaeSwap, GeniusYield and SaturnSwap fills are attributed less often for now. SundaeSwap records the order’s owner as a key that can be a stake key, so many of its rows give only the payout wallet as recipient (PLACER_UNRESOLVED) or no trader (OWNER_NOT_PAYMENT_CREDENTIAL). GeniusYield and SaturnSwap fills often have no resolved wallet yet.
  • Direct pool swaps, arbitrage, and pool-only venues (VyFi, CSwap and TeddySwap pool rows) mostly come back UNATTRIBUTED. Nexus marks them rather than guess.
  • MEDIUM and LOW answers are returned, not dropped. Filter on confidence and attribution if you only want the strongest links. flags is separate from confidence: a MEDIUM or LOW trader can have an empty flags list.
  • A pool, order, launchpad or DEX contract address is never returned as a trader, as trader or as recipient. Such a row is UNATTRIBUTED with VENUE_SCRIPT.
  • When the four fields are absent, attribution was not available for that response. Treat the trader as unknown, not as a row without one. This can be temporary, so do not cache an absent answer as final: read the row again later.
  • Use trader, not ownerPkh, to link wallets. ownerPkh is unchanged and stays a raw credential: on some DEXes it is a stake key hash or a contract hash rather than a wallet’s payment key.
Top traders (/api/dex/tokens/{policyId}/{assetName}/top-traders) never lists a known pool, order, launchpad or DEX contract credential as a wallet either.

NFT

Blueprints, leaderboard & sync

Example

Stream prices in real time

Pair Market Data with a WebSocket package to receive live price and swap updates instead of polling.

Host a market page

Skip building a front end: put a full Cardano market page on your own site with the hosted market kit and a public partner key.
Full request/response schemas for every endpoint are in the API Reference.