> For the complete documentation index, see [llms.txt](https://docs.wildmeta.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wildmeta.ai/trading-terminal/x402-support-and-extension/data-provider/biggest-position-list.md).

# 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**

```json
{
  "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"
    }
  }
}
```