DH
3 min read·Updated 2026-06-14

List market positions

Scanned-wallet open positions in a single market, filterable by direction.

GET/networks/{network}/markets/{asset}/whale-positions

Inspect the wallets that currently hold an open position in an asset. The optional direction is long or short. Despite the whale-positions path, results are not limited to large positions.

Path Params
networkstringrequired

Network identifier. Only hyperliquid is supported.

Example: hyperliquid

assetstringrequired

Canonical asset symbol or network symbol (e.g. BTC, ETH, xyz:SP500).

Example: BTC

Query Params
directionstring

Filter by side: long or short.

limitinteger

Maximum results per page. Default 25, hard cap 200.

Example: 25

cursorstring

Cursor value from the previous page's nextCursor field.

Responses

200OK

Paginated list of scanned-wallet open positions in the asset.

Schema
itemsobject[]

Open positions held by scanned wallets in the asset.

addressstring

Wallet address holding the position.

labelstringnullable

Human label if DexHunt has one.

tagsstring[]

Classification tags for the wallet.

symbolstring

Asset symbol of the position.

directionstring

Position side — long or short.

positionValuestring (decimal)

Current notional value in USD.

liqPricestringnullable

Estimated liquidation price.

observedAtstring (ISO 8601)

When the position snapshot was taken.

leveragestringnullable

Position leverage multiplier.

sizestringnullable

Position size in base units.

sizeUnitstringnullable

Unit for size (the base asset).

uPnlstringnullable

Unrealized PnL in USD.

uPnlPctstringnullable

Unrealized PnL as a percentage.

entryPricestringnullable

Average entry price.

markPricestringnullable

Current mark price.

marginstringnullable

Margin allocated to the position.

fundingCoststringnullable

Cumulative funding paid (negative) or received.

nextCursorstringnullable

Cursor for the next page, or null at the end.

coveragestring

Always scanned_wallets for this endpoint.

400Bad Request
401Unauthorized
404Not Found
500Server Error
Request
curl -sS "https://api.dexhunt.app/v1/networks/hyperliquid/markets/BTC/whale-positions?direction=long&limit=2" \
  -H "X-API-Key: hlsk_your_developer_key"
Response
200 · OK
{
  "items": [
    {
      "address": "0x1111111111111111111111111111111111111111",
      "label": null,
      "tags": ["whale", "high_quality"],
      "symbol": "BTC",
      "direction": "long",
      "positionValue": "3000000.00",
      "liqPrice": "60350.5",
      "observedAt": "2026-06-12T12:00:00Z",
      "leverage": "5",
      "size": "44.75",
      "sizeUnit": "BTC",
      "uPnl": "38000.10",
      "uPnlPct": "6.33",
      "entryPrice": "66150.2",
      "markPrice": "67000.5",
      "margin": "600000.00",
      "fundingCost": "-1200.45"
    }
  ],
  "nextCursor": "2",
  "coverage": "scanned_wallets"
}