# 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"
    }
  }
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.wildmeta.ai/trading-terminal/x402-support-and-extension/data-provider/biggest-position-list.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.