Skip to main content

Gathering Data

Before we build the ticker, walk through the APIs it consumes: wallet contents, token prices, NFT floors.

Educational use only

The endpoints below are for educational use. Some are not officially supported by their providers. For production, use official (mostly paid) APIs or build your own.

Checking your wallet​

You already know several ways to fetch wallet data from earlier in this section:

The next sections add token prices and NFT floors on top.

Fetching from MinSwap​

MinSwap is a leading DEX on Cardano. It exposes an endpoint to fetch all tokens (and prices) for a wallet address:

https://monorepo-mainnet-prod.minswap.org/v1/portfolio/tokens?address=[WALLETADDRESS]&only_minswap=true&filter_small_value=false

Replace [WALLETADDRESS] with your wallet address. The response is JSON:

{
  "positions": {
    "nft_positions": [
      {
        "currency_symbol": "f0ff48bbb7bbe9d59a40f1ce90e9e9d0ff5002ec48f232b49ca0fb9a",
        "token_name": "000de14063617264616e6f7468696e6773",
        "is_verified": true
      }
    ],
    "asset_positions": [
      {
        "asset": {
          "currency_symbol": "",
          "token_name": "",
          "is_verified": true,
          "metadata": {
            "decimals": 6,
            "name": "Cardano",
            "ticker": "ADA"
          }
        },
        "price_usd": 0.3864,
        "amount": 11.37058,
        "amount_usd": 4.393592112,
        "pnl_24h_usd": -0.3466696040696063,
        "pnl_24h_percent": -7.8903456495828275
      },
      {
        "asset": {
          "currency_symbol": "3d77d63dfa6033be98021417e08e3368cc80e67f8d7afa196aaa0b39",
          "token_name": "53746172636820546f6b656e",
          "is_verified": true,
          "metadata": {
            "name": "STRCH",
            "url": "https://starch.one",
            "ticker": "STRCH",
            "decimals": 0,
            "description": ""
          }
        },
        "price_usd": 3.0215906268916395e-9,
        "amount": 114081,
        "amount_usd": 0.00034470608030642515,
        "pnl_24h_usd": -0.00005476157689164048,
        "pnl_24h_percent": -15.88645516289135
      }
    ],
    "lp_asset_positions": []
  }
}

You get NFTs in the wallet, tokens, USD price per token, amounts, 24h USD change, and 24h percent change - enough to render token rows on the ticker.

Fetching from JPG.store (no longer)​

JPG.store is the largest NFT marketplace on Cardano. Unfortunately they've locked down their API since this workshop was written - no public or paid endpoints are available anymore.

Cexplorer.io for NFT floors​

Cexplorer.io saves the day with a free tier. Sign up, click your wallet address (top right) to reach your profile, click the API tab, and create a new project to get an API key.

Cexplorer also ships a Node.js SDK at github.com/vellum-labs/cexplorer-api.

We'll use it to fetch floor prices for NFT collections via:

https://api-mainnet-stage.cexplorer.io/v1/policy/detail?id=[POLICYID]

Replace [POLICYID] with the collection's policy ID. Example response:

{
  "license": "private/dev usage only.",
  "code": 200,
  "data": {
    "id": "f0ff48bbb7bbe9d59a40f1ce90e9e9d0ff5002ec48f232b49ca0fb9a",
    "policy": {
      "mintc": 320782,
      "stats": null,
      "script": {
        "json": {
          "type": "sig",
          "keyHash": "4da965a049dfd15ed1ee19fba6e2974a0b79fc416dd1796a1f97f5e1"
        },
        "type": "timelock"
      },
      "quantity": 310506,
      "last_mint": "2025-12-01T08:58:06",
      "first_mint": "2021-12-14T16:00:24"
    },
    "collection": {
      "url": "adahandle",
      "name": "ADA Handle",
      "stats": {
        "floor": 5000000,
        "owners": 66766,
        "volume": 612934424304312,
        "royalties": {
          "rate": 0.02,
          "address": "addr1qye59j5vquaprdmxf0gs2y3n20necqg3dnzxty23x07u7awkchm0w43pg2uczh4vcvdr59teny2996rq4tmq2umjyqvqlhm7d2"
        }
      }
    }
  },
  "tokens": 4,
  "ex": 0.0174,
  "debug": false
}

The ticker uses the collection name, owners, volume, and floor (in lovelace).

API key required

Include your API key in the api-key request header. Without it you'll get 401 Unauthorized or empty data. The free tier has rate limits.

Other APIs​

For production tickers, two paid options worth considering:

  • TapTools - a Cardano analytics platform with detailed token, portfolio, and market data; tiered pricing. API docs.
  • Charli3 - a Cardano oracle / API provider with historical and live token prices, free + paid tiers. Token API.

What's next?​

You now have all the data the ticker needs. The next lesson assembles it into a multi-screen TFT display.

Further Resources​

Adapted from the CardanoThings workshop series, originally produced under Project Catalyst Fund 11. Source code: github.com/CardanoThings/Workshops/Workshop-04.