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