DegenZone
Launch app
API reference

REST API

Six read-only JSON endpoints. No authentication on the free tier (rate-limited per IP). Whale tier subscribers get an API key with 10 RPS quota and webhook support.

Base URL
https://degenzone.com
GET/api/tokens

Top 150 memecoin/altcoin tokens on the selected chain, enriched with narrative tag, smart-money score, and recent buyer wallets.

Query parameters
NameTypeRequiredDescription
chainenumyessolana | base | bsc | eth
timeframeenumnom5 | h1 | h6 | h24 (default: h24). Determines which volume bucket is used for ranking.
minLiqnumbernoMin liquidity USD (default: 50000)
maxAgenumbernoMax pool age in hours. Setting this enables Fresh-mode (relaxed quality filters).
Example request
curl 'https://degenzone.com/api/tokens?chain=solana&timeframe=h1&minLiq=100000'
Response
{
  "tokens": [
    {
      "address": "EKpQGSJtjMFqKZ9KQanSqYXRcF8fBopzLHYxdM65zcjm",
      "pairAddress": "EP2ib6dYdEeqD8MfE2ezHCxX3kP3K2eLKkirfPm5eyMx",
      "symbol": "WIF",
      "name": "dogwifhat",
      "imageUrl": "https://dd.dexscreener.com/...",
      "priceUsd": 2.341,
      "liquidityUsd": 412183091.23,
      "marketCapUsd": 2341000000,
      "fdvUsd": 2341000000,
      "volumeUsd":      { "m5": 12450, "h1": 1245009, "h6": 12450091, "h24": 142183091 },
      "priceChangePct": { "m5": 0.45, "h1": -1.21, "h6": 5.4, "h24": 18.43 },
      "buys24h": 12340, "sells24h": 11201, "buys1h": 643, "sells1h": 502,
      "poolCreatedAt": "2024-03-04T01:23:45Z",
      "ageHours": 12480,
      "chain": "solana",
      "dexId": "raydium",
      "narrativeId": "dog",
      "smartScore": 0.78,
      "smartBuyers": [{ "alias": "Cented7", "address": "5B52..." }]
    }
  ],
  "source": "geckoterminal",
  "fetchedAt": 1742284800000,
  "delayed": false
}
GET/api/portfolio

Real Solana wallet holdings via on-chain RPC, cross-referenced with the live token cache for prices and 24h P&L. Currently Solana-only.

Query parameters
NameTypeRequiredDescription
walletstring (base58)yesSolana wallet address, 32–44 chars
Example request
curl 'https://degenzone.com/api/portfolio?wallet=4hHQemDr8zKbVH7ZB7vXjCsAvBVtMNDqFvtRYM5UCnvw'
Response
{
  "wallet": "4hHQemDr8zKbVH7ZB7vXjCsAvBVtMNDqFvtRYM5UCnvw",
  "source": "solana-rpc",
  "holdings": [
    {
      "address": "EKpQGSJtjMFqKZ9KQanSqYXRcF8fBopzLHYxdM65zcjm",
      "symbol": "WIF",
      "name": "dogwifhat",
      "uiAmount": 1850.2,
      "decimals": 6,
      "priceUsd": 2.341,
      "priceChange24h": 18.43,
      "balanceUsd": 4332,
      "unpriced": false
    }
  ],
  "totalUsd": 12450,
  "pricedHoldings": 6,
  "unpricedHoldings": 2,
  "change24hPct": 8.4,
  "change24hUsd": 968
}
GET/api/snapshot

Time-Machine snapshot of the chain N minutes ago, plus metadata about the snapshot store.

Query parameters
NameTypeRequiredDescription
chainenumyessolana | base | bsc | eth
agonumbernoMinutes ago (default: 60). Common values: 15, 60, 240.
Example request
curl 'https://degenzone.com/api/snapshot?chain=solana&ago=60'
Response
{
  "chain": "solana",
  "requestedAgoMinutes": 60,
  "available": 240,
  "range": {
    "oldestTs": 1742270400000,
    "newestTs": 1742284800000,
    "oldestAgoMinutes": 240
  },
  "snapshot": {
    "ts": 1742281200000,
    "agoMinutes": 60,
    "tokens": [/* Token[] same shape as /api/tokens */]
  }
}
GET/api/ohlcv

OHLCV candles for a specific pool. Used internally by the side-panel sparkline.

Query parameters
NameTypeRequiredDescription
chainenumyessolana | base | bsc | eth
pairstringyesPool / pair address (base58 for Solana, 0x... for EVM)
timeframeenumnominute | hour | day (default: hour)
aggregatenumbernoAggregation per candle (default: 1)
limitnumbernoMax candles (default: 48, max: 200)
pricenumbernoFallback price used by the demo generator if upstream is unreachable
Example request
curl 'https://degenzone.com/api/ohlcv?chain=solana&pair=EP2ib6dYdEeqD8MfE2ezHCxX3kP3K2eLKkirfPm5eyMx&limit=48'
Response
{
  "candles": [
    { "t": 1742281200, "o": 2.31, "h": 2.36, "l": 2.30, "c": 2.34, "v": 1245000 }
  ],
  "source": "geckoterminal"
}
GET/api/poller

Heartbeat for the on-chain smart-money poller. Returns count of tracked wallets and last-cycle stats.

Example request
curl 'https://degenzone.com/api/poller'
Response
{
  "walletsTracked": 10,
  "stats": {
    "last_run_at": "1742284800000",
    "last_scanned": "47",
    "last_new_buys": "3",
    "last_errors": "0"
  }
}
GET/api/health

System health probe — upstream provider status, uptime, snapshot counts. Backs the /status page.

Example request
curl 'https://degenzone.com/api/health'
Response
{
  "status": "operational",
  "uptimeMs": 86400000,
  "uptimeHuman": "1d 0h",
  "providers": {
    "geckoterminal": "up",
    "dexscreener": "up"
  },
  "snapshots": {
    "solana": { "count": 240, "oldestTs": 1742270400000, "newestTs": 1742284800000 }
  },
  "timestamp": 1742284800000
}
← DocumentationStatus →