Hyperliquid Position Distribution (By Tag)

This API provides position distribution data for each symbol on Hyperliquid across different tag-based groups, including address counts, position sizes, profit and loss status, and long/short information.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Cache / Update Frequency: Updated every 15 minutes.

This endpoint is available on the following API plans

PlansHobbyistStartupStandardProfessionalEnterprise
Available

Response Data

{
  "code": "0",
  "data": [
    {
      "group_name": "shrimp",
      "all_address_count": 437459,
      "position_address_count": 24211,
      "bias_score": -0.46,
      "bias_remark": "bearish",
      "minimum_amount": 0,
      "maximum_amount": 250,
      "long_position_usd": 35743441.157706,
      "short_position_usd": 14388750.286128,
      "position_usd": 50132191.443834,
      "profit_address_count": 12307,
      "loss_address_count": 12558
    },
    {
      "group_name": "shrimp",
      "all_address_count": 437468,
      "position_address_count": 24287,
      "bias_score": -0.45,
      "bias_remark": "bearish",
      "minimum_amount": 0,
      "maximum_amount": 250,
      "long_position_usd": 36145526.276199,
      "short_position_usd": 15119941.085077,
      "position_usd": 51265467.361276,
      "profit_address_count": 12349,
      "loss_address_count": 12586
    },
    ] 
}
Query Params
string
required
Defaults to 10m

Time interval for data aggregation. Supported values: 10m, 1h,1d

string
required
Defaults to Shrimp

Supported tags: Shrimp, Fish, Dolphin, Apex_Predator, Small_Whale, Whale, Tidal_Whale, Leviathan, Money_Printer, Smart_Money, Grinder, Humble_Earner, Exit_Liquidity, Semi_Rekt, Full_Rekt, Giga_Rekt

string

Number of results per request. Default: 1000, Maximum: 1000

int64

Start timestamp in milliseconds (e.g., 1641522717000).

int64

End timestamp in milliseconds (e.g., 1641522717000).

Response
200
Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here!