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.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 optionalsource 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.
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.
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
HIGHconfidence. MuesliSwap V1 orders name their owner less reliably and come backLOW. - 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. MEDIUMandLOWanswers are returned, not dropped. Filter onconfidenceandattributionif you only want the strongest links.flagsis separate fromconfidence: aMEDIUMorLOWtrader can have an emptyflagslist.- A pool, order, launchpad or DEX contract address is never returned as a trader, as
traderor asrecipient. Such a row isUNATTRIBUTEDwithVENUE_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, notownerPkh, to link wallets.ownerPkhis 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.
/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.