# Trade Story

### `GET /tradestory/{address}`

**Description:** Analyze the trading behaviour of the specified wallet address within a given time window and generate a “trade story” and market interpretative commentary.

#### **Request**

**HTTP Method:** `GET`\
**Endpoint:**

```
/tradestory/{address}
```

**Path Parameter**

| Name      | Type   | Description               |
| --------- | ------ | ------------------------- |
| `address` | string | Wallet address to analyse |

**Query Parameters (optional)**

| Name             | Type   | Description                                             |
| ---------------- | ------ | ------------------------------------------------------- |
| `window_seconds` | number | Time-window in seconds; if not provided defaults to `0` |
| `startTime`      | number | Start timestamp in seconds (UNIX epoch)                 |
| `endTime`        | number | End timestamp in seconds (UNIX epoch)                   |

#### **Response**

**Content Type:** `application/json`\
**Fields:**

| Name      | Type   | Description                                                      |
| --------- | ------ | ---------------------------------------------------------------- |
| `message` | string | Response message providing the trade story and market commentary |

#### **Functionality**

This endpoint analyses the trading actions of the given wallet address over the specified time range (or default window) and produces a narrative “trade story” — summarising the trading behaviour, key trades, patterns, and provides a market-interpretation or commentary intended to contextualise the wallet’s activity.

#### **Example**

**Request:**

```
GET https://openapi.wildmeta.ai/dataprovider/v1/tradestory/0xAbC123…?window_seconds=3600&startTime=1636500000&endTime=1636503600
```

**Response:**

```json
{
  "message": "Over the past hour the address 0xAbC123… executed 5 buys and 2 sells, shifting from Token X into Token Y ahead of the market rally. The aggressive accumulation suggests anticipation of a breakout, while the subsequent partial profit taking aligns with rising volatility. Market sentiment remains bullish on Token Y given recent liquidity flows."
}
```


---

# 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/trade-story.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.