API & EMBED

Developers

Every number on this site comes from two public endpoints below — no API key, no auth, open CORS (Access-Control-Allow-Origin: *), refreshed every 30s.

GET/api/premium

Every tracked ticker's live premium in one call — this is exactly what powers the homepage table.

REQUEST

curl https://gapline.xyz/api/premium

RESPONSE

{
  "updatedAt": 1753142400,
  "stocks": [
    {
      "ticker": "NVDA",
      "name": "NVIDIA",
      "tokenPrice": 213.96,
      "official": 207.04,
      "officialUpdatedAt": 1753056000,
      "premiumPct": 3.34,
      "volume24h": 3589862.74,
      "liquid": true
    },
    ...
  ]
}

GET/api/premium/{ticker}

Same shape as above, scoped to one ticker. Returns 404 with { "error": ... } if the ticker isn't tracked or has no live price right now.

REQUEST

curl https://gapline.xyz/api/premium/NVDA

RESPONSE

{
  "ticker": "NVDA",
  "name": "NVIDIA",
  "tokenPrice": 213.96,
  "official": 207.04,
  "officialUpdatedAt": 1753056000,
  "premiumPct": 3.34,
  "volume24h": 3589862.74,
  "liquid": true,
  "updatedAt": 1753142400
}

Field reference

Field	Meaning
tokenPrice	Live DEX price the token trades at on Robinhood Chain, USD.
official	Frozen Chainlink close — only updates during NYSE hours.
officialUpdatedAt	Unix seconds the Chainlink feed last updated.
premiumPct	(tokenPrice − official) / official × 100.
volume24h	24h onchain volume, USD, or null if Blockscout doesn't know it.
liquid	false below $1,000 24h volume — DEX price may be stale.

Embeddable widget

/embed/{ticker} is a bare, iframe-able HTML card — same data, refreshed every 30s. Try it below:

Embed this on your site

<iframe src="https://gapline.xyz/embed/NVDA" width="280" height="130" frameborder="0" style="border:none;"></iframe>

No rate limit is enforced today — be a reasonable citizen.

Found a bug or want a field added? Reach out via X (@noc_vault).