10 min read·Updated 2026-06-12

Rankings and Activity

Ready-to-render overview, leaderboard, activity-feed, and news endpoints for DexHunt integrations.

Choose a discovery surface

Discovery endpoints compose data into ready-to-render lists: network overview cards, trader leaderboards, asset boards, recent whale moves, and market news. They are read-only and use the same developer-token authentication as the rest of the external API.

Landing data

Use overview for dashboard-style first screens. It bundles top gainers, liquidation summaries, top traders, and recent moves.

overview

Leaderboards

Use trader rankings when the integration needs a focused leaderboard with metric and cohort filters.

rankings/traders

Feeds

Use whale activity for a recent-position feed over scanned smart-money wallets.

whale-activity

News

Use market news for short article summaries indexed by DexHunt without exposing raw source links.

market-news

Read network overview

The overview endpoint returns a compact network snapshot for a dashboard or application home screen.

Request

bash

curl -sS "https://api.dexhunt.app/api/developer/v1/networks/hyperliquid/overview" \
  -H "X-API-Key: hlsk_your_developer_key"

Example response

json

{
  "indexedAddresses": 128450,
  "totalAccountValue": "842000000.50",
  "marketLongShort": {
    "longNotionalUsd": "245000000",
    "shortNotionalUsd": "198000000"
  },
  "topGainers": [
    {
      "symbol": "BTC",
      "price": "67000.5",
      "change24hPct": "1.42",
      "volume24h": "1850000000",
      "openInterest": "910000000",
      "funding": "0.0000125",
      "longCount": 118,
      "shortCount": 94,
      "longShortRatio": "1.255319",
      "totalLiquidationValue": "167973714",
      "longLiquidationValue": "111386355",
      "shortLiquidationValue": "56587359"
    }
  ],
  "biggestLiquidations": [
    {
      "symbol": "BTC",
      "side": "long",
      "price": null,
      "value": "111386355"
    }
  ],
  "topTraders": [],
  "recentWhaleMoves": []
}

Rank traders

Trader rankings rank profile-derived metrics over a bounded candidate pool. Supported metrics are pnl, roi, and volume. The periodis echoed in the response and defaults to 7d.

Capital cohorts

Filter by capital tags such as shrimp, fish, dolphin, shark, small_whale, whale, tidal_whale, leviathan.

capital

Quality cohorts

Filter by quality tags such as positive_expectancy, consistent_operator, high_quality, exceptional.

quality

Strategy style

Filter by strategy style such as lowDd, stableProfit, hiRiskHiReturn, aggrHiFreq, volatileStrategy.

style

Asset filter

Filter by a traded asset. Unknown assets return 404.

asset=BTC

Request

bash

curl -sS "https://api.dexhunt.app/api/developer/v1/networks/hyperliquid/rankings/traders?metric=roi&period=30d&quality=high_quality&asset=BTC&limit=3" \
  -H "X-API-Key: hlsk_your_developer_key"

Example response

json

{
  "items": [
    {
      "rank": 1,
      "address": "0x1111111111111111111111111111111111111111",
      "label": null,
      "accountValue": "12500000.42",
      "pnl": "820000.12",
      "roi": "7.12",
      "volume": "98100000.50"
    }
  ],
  "period": "30d",
  "metric": "roi"
}

Rank assets

Asset rankings are built from the market snapshot. Supported board values are volume, gainers, losers, and popular. The default board is volume.

Request

bash

curl -sS "https://api.dexhunt.app/api/developer/v1/networks/hyperliquid/rankings/assets?board=gainers&limit=3" \
  -H "X-API-Key: hlsk_your_developer_key"

Example response

json

{
  "items": [
    {
      "rank": 1,
      "symbol": "BTC",
      "price": "67000.5",
      "changePct": "1.42",
      "volume": "1850000000",
      "listedAt": null
    }
  ],
  "board": "gainers"
}

Read whale activity

Whale activity returns recent open-position observations over the tracked wallet universe. The default limit is 25 and the hard cap is 200.

Request

bash

curl -sS "https://api.dexhunt.app/api/developer/v1/networks/hyperliquid/whale-activity?limit=2" \
  -H "X-API-Key: hlsk_your_developer_key"

Example response

json

{
  "items": [
    {
      "id": "0x1111111111111111111111111111111111111111:BTC:long",
      "address": "0x1111111111111111111111111111111111111111",
      "label": null,
      "direction": "long",
      "symbol": "BTC",
      "marginMode": null,
      "positionValue": "3000000.00",
      "size": null,
      "sizeUnit": null,
      "price": null,
      "at": "2026-06-12T12:00:00Z"
    }
  ],
  "nextCursor": "2"
}

Read market news

Market news returns the latest indexed article summaries. Raw source links are not part of the public DTO.

Request

bash

curl -sS "https://api.dexhunt.app/api/developer/v1/networks/hyperliquid/market-news?limit=2" \
  -H "X-API-Key: hlsk_your_developer_key"

Example response

json

{
  "items": [
    {
      "id": "a36d5f...",
      "source": "crypto-news51",
      "headline": "Bitcoin liquidity clusters near the current range",
      "body": "Market participants are watching nearby liquidity levels as open interest remains elevated.",
      "at": "2026-06-12T11:45:00Z",
      "category": "market",
      "subCategory": "bitcoin",
      "language": "en",
      "sentimentLabel": "neutral",
      "sentimentScore": 0.0
    }
  ],
  "nextCursor": "eyJzb3J0IjpbXX0=",
  "network": "hyperliquid"
}

What to do next

Wallets

Use wallet profiles and profile analytics to explain trader leaderboard entries.

Drill down

Markets

Use markets and liquidation levels to explain asset leaderboard entries.

Market context

Endpoint catalog

Check all routes and query params before building a generated client.

Lookup

API Reference

Wallets

Wallet directory, wallet detail, profile analytics, open orders, fills, funding, and transfers in the DexHunt external API.

API Reference

Markets

Market snapshots, market detail, scanned wallet positions, and liquidation-level aggregates in the DexHunt external API.

API Reference

Endpoint Catalog

Complete catalog of DexHunt external API endpoints under /api/developer/v1.