Biggest Position List

GET /topposition/addresses

Description: Retrieve the addresses with the largest positions within a specified number of hours, along with generated trade stories and insights into influential market participants.

---

Request

HTTP Method: GET Endpoint:

/topposition/addresses

Query Parameters

Name	Type	Description
hours	number	Number of hours to query; optional, default is 24

---

Response

Content Type: application/json

Field	Type	Description
actions	ActionList[]	Trading actions associated with top positions
traders	object	Trader information mapped by address

If you want, I can also help define the structure of ActionList and traders once you provide their fields.

---

Functionality

This endpoint analyzes large position holders over a specified timeframe, identifies traders with significant market exposure, and generates narratives that highlight their strategies and potential influence on market dynamics.

It is particularly useful for detecting whales, high-impact traders, and position-based sentiment indicators.

---

Example Request

GET https://openapi.wildmeta.ai/dataprovider/v1/topposition/addresses?hours=24

Example Response

{
  "actions": [
    {
      "address": "0xA1b2...c3d4",
      "token": "TOKENA",
      "positionSize": 120000,
      "story": "This trader accumulated a large long position in TOKENA over the past 24 hours, signaling strong conviction ahead of increasing market liquidity."
    }
  ],
  "traders": {
    "0xA1b2...c3d4": {
      "nickname": "DeepPocket",
      "avatar": "https://example.com/avatar3.png",
      "address": "0xA1b2...c3d4"
    }
  }
}