# Get Trade

Returns token trades with the coldkey, source and destination amounts, TAO and USD values, and extrinsic ID.

_Source: https://beta.taostats.io/docs/api-reference/delegation/get-trade_

_Last reviewed: 2026-10-12_

```http
GET https://api.taostats.io/api/dtao/trade/v1
```

Requires an API key in the `Authorization` header.

> [!WARNING]
> **This API is retired on November 9, 2026**
>
> Every endpoint in this reference — every path that starts with `/api/` — stops working on **November 9, 2026**. The [new Taostats API](https://beta.taostats.io/docs/new) replaces it: same key, new paths under `https://api.taostats.io/v1/`. Move your integration to the [new API reference](https://beta.taostats.io/docs/new) before then.

Returns token trades with the coldkey, source and destination amounts, TAO and USD values, and extrinsic ID. Filter by wallet, token names, trade value or block and time ranges.

## Try it

Try this request in the browser on the HTML version of this page, or use the code samples below.

### Examples

List executed stake trades for a wallet

```text
https://api.taostats.io/api/dtao/trade/v1?coldkey=5GH2aUTMRUh1RprCgH4x3tRyCaKeUi5BfmYCfs1NARA8R54n&limit=50
```

Find large executed trades over 1,000 TAO in value, newest first

```text
https://api.taostats.io/api/dtao/trade/v1?tao_value_min=1000000000000&order=tao_value_desc&limit=50
```

### Code samples

**cURL**

```bash
curl -H "Authorization: <YOUR_API_KEY>" \
  "https://api.taostats.io/api/dtao/trade/v1?coldkey=5GH2aUTMRUh1RprCgH4x3tRyCaKeUi5BfmYCfs1NARA8R54n&limit=50"
```

**JavaScript**

```js
const response = await fetch('https://api.taostats.io/api/dtao/trade/v1?coldkey=5GH2aUTMRUh1RprCgH4x3tRyCaKeUi5BfmYCfs1NARA8R54n&limit=50', {
  headers: {
    Authorization: '<YOUR_API_KEY>',
  },
});
const data = await response.json();
```

**Python**

```python
import requests

response = requests.get(
    "https://api.taostats.io/api/dtao/trade/v1?coldkey=5GH2aUTMRUh1RprCgH4x3tRyCaKeUi5BfmYCfs1NARA8R54n&limit=50",
    headers={"Authorization": "<YOUR_API_KEY>"},
)
data = response.json()
```

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `coldkey` | query | `string` |  | SS58 or hex format |
| `extrinsic_id` | query | `string` |  |  |
| `from_name` | query | `string` |  |  |
| `to_name` | query | `string` |  |  |
| `tao_value_min` | query | `string` |  | Minimum amount (inclusive) |
| `tao_value_max` | query | `string` |  | Maximum amount (inclusive) |
| `usd_value_min` | query | `string` |  | Minimum amount (inclusive) |
| `usd_value_max` | query | `string` |  | Maximum amount (inclusive) |
| `block_number` | query | `integer (int32)` |  |  |
| `block_start` | query | `integer (int32)` |  | Start of block range (inclusive) |
| `block_end` | query | `integer (int32)` |  | End of block range (inclusive) |
| `timestamp_start` | query | `integer (int64)` |  | Start of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive) |
| `timestamp_end` | query | `integer (int64)` |  | End of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive) |
| `page` | query | `integer (int32)` |  |  |
| `limit` | query | `integer (int32)` |  |  |
| `order` | query | `string` |  | One of `block_number_asc`, `block_number_desc`, `timestamp_asc`, `timestamp_desc`, `from_amount_asc`, `from_amount_desc`, `to_amount_asc`, `to_amount_desc`, `tao_value_asc`, `tao_value_desc`, `usd_value_asc`, `usd_value_desc`. |

## Responses

### `200` — Dtao trades retrieved successfully

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `data` | `array` | Yes |  |
| `data[].block_number` | `integer (int32)` | Yes |  |
| `data[].coldkey` | `object` | Yes |  |
| `data[].coldkey.hex` | `string` | Yes | The hex format of the hot key |
| `data[].coldkey.ss58` | `string` | Yes | The SS58 format of the hot key |
| `data[].extrinsic_id` | `string` | Yes |  |
| `data[].from_amount` | `string` | Yes |  |
| `data[].from_name` | `string` | Yes |  |
| `data[].tao_value` | `string` | Yes |  |
| `data[].timestamp` | `string (date-time)` | Yes |  |
| `data[].to_amount` | `string` | Yes |  |
| `data[].to_name` | `string` | Yes |  |
| `data[].usd_value` | `string` | Yes |  |
| `pagination` | `object` | Yes |  |
| `pagination.current_page` | `integer (int32)` | Yes |  |
| `pagination.next_page` | `integer (int32), nullable` |  |  |
| `pagination.per_page` | `integer (int32)` | Yes |  |
| `pagination.prev_page` | `integer (int32), nullable` |  |  |
| `pagination.total_items` | `integer (int32)` | Yes |  |
| `pagination.total_pages` | `integer (int32)` | Yes |  |

### Other responses

| Status | Meaning |
| --- | --- |
| `400` | Bad request |
| `404` | Dtao trades not found |
| `500` | Internal server error |

Every request needs an `Authorization` header holding your API key — see [Getting started with the Taostats API](https://beta.taostats.io/docs/start-here/getting-started-with-taostats-api).