# Trades

## Stream trades in all pairs in Standard spot exchange

### ✅ Request

{% tabs %}
{% tab title="Subscription" %}
{% code title="Subscription" %}

```json
{
  "id": 1,
  "method": "spot.trades.subscribe.pairs.all",
  "params": null
}
```

{% endcode %}
{% endtab %}

{% tab title="Unsubscription" %}
{% code title="Unsubscription" %}

```json
{
  "id": 1,
  "method": "spot.trades.unsubscribe.pairs.all",
  "params": null
}
```

{% endcode %}
{% endtab %}
{% endtabs %}

### 📤 Response

{% tabs %}
{% tab title="Success" %}
{% code title="Success" %}

```json
{
  "result": null,
  "id": 1
}
```

{% endcode %}
{% endtab %}

{% tab title="Error" %}
{% code title="Error" %}

```json
{
  "code": 1,
  "msg": "Internal Error: {error}"
}
```

{% endcode %}
{% endtab %}
{% endtabs %}

### 📡 Streamed Data Format

{% code title="Trade Stream" %}

```json
[
  "spotTrade",                  // eventId
  987654,                       // orderId
  "0xBaseTokenAddress",         // base token address
  "0xQuoteTokenAddress",        // quote token address
  "ETH",                        // base token symbol
  "USDC",                       // quote token symbol
  "0xPairAddress",              // pair contract address
  "ETH/USDC",                   // pair symbol
  true,                         // isBid (true = buy, false = sell)
  3142.25,                      // price
  "0xUserAddress",              // account (initiator)
  "0xAssetAddress",             // traded asset address
  "ETH",                        // traded asset symbol
  1.5,                          // amount (of asset)
  4713.375,                     // valueUSD
  1.5,                          // baseAmount
  4713.375,                     // quoteAmount
  1713657900,                   // timestamp (Unix)
  "0xTakerAddress",             // taker address
  "0xMakerAddress",             // maker address
  "0xTransactionHash"           // transaction hash
]
```

{% endcode %}

### 📄 Field Descriptions

| Index | Field         | Type    | Description                              |
| ----- | ------------- | ------- | ---------------------------------------- |
| 0     | `eventId`     | String  | Unique event identifier                  |
| 1     | `orderId`     | Number  | ID of the trade order                    |
| 2     | `base`        | String  | Base token address                       |
| 3     | `quote`       | String  | Quote token address                      |
| 4     | `baseSymbol`  | String  | Symbol of base token                     |
| 5     | `quoteSymbol` | String  | Symbol of quote token                    |
| 6     | `pair`        | String  | Address of the pair contract             |
| 7     | `pairSymbol`  | String  | Symbol of the pair (e.g., `ETH/USDC`)    |
| 8     | `isBid`       | Boolean | `true` if it's a buy, `false` if sell    |
| 9     | `price`       | Number  | Price per unit in quote token            |
| 10    | `account`     | String  | Address of the user initiating the trade |
| 11    | `asset`       | String  | Address of the asset being traded        |
| 12    | `assetSymbol` | String  | Symbol of the traded asset               |
| 13    | `amount`      | Number  | Amount of asset traded                   |
| 14    | `valueUSD`    | Number  | Trade value in USD                       |
| 15    | `baseAmount`  | Number  | Volume in base token                     |
| 16    | `quoteAmount` | Number  | Volume in quote token                    |
| 17    | `timestamp`   | Number  | Unix timestamp of the trade              |
| 18    | `taker`       | String  | Taker address                            |
| 19    | `maker`       | String  | Maker address                            |
| 20    | `txHash`      | String  | Transaction hash                         |

## Stream trades in specific pairs in Standard spot exchange

### ✅ Request

{% tabs %}
{% tab title="Subscription" %}
{% code title="Subscription" %}

```json
{
  "id": 1,
  "method": "spot.trades.subscribe.pairs",
  "params": {
    "pairs": ["ETH/USDC", "WBTC/USDT"]
  }
}
```

{% endcode %}
{% endtab %}

{% tab title="Unsubscription" %}
{% code title="Unsubscription" %}

```json
{
  "id": 1,
  "method": "spot.trades.unsubscribe.pairs",
  "params": {
    "pairs": ["ETH/USDC", "WBTC/USDT"]
  }
}
```

{% endcode %}
{% endtab %}
{% endtabs %}

### 📤 Response

{% tabs %}
{% tab title="Success" %}
{% code title="Success" %}

```json
{
  "result": null,
  "id": 1
}
```

{% endcode %}
{% endtab %}

{% tab title="Error" %}
{% code title="Error" %}

```json
{
  "code": 1,
  "msg": "Internal Error: {error}"
}
```

{% endcode %}
{% endtab %}
{% endtabs %}

### 📡 Streamed Data Format

{% code title="Trade Stream" %}

```json
[
  "spotTrade",                  // eventId
  987654,                       // orderId
  "0xBaseTokenAddress",         // base token address
  "0xQuoteTokenAddress",        // quote token address
  "ETH",                        // base token symbol
  "USDC",                       // quote token symbol
  "0xPairAddress",              // pair contract address
  "ETH/USDC",                   // pair symbol
  true,                         // isBid (true = buy, false = sell)
  3142.25,                      // price
  "0xUserAddress",              // account (initiator)
  "0xAssetAddress",             // traded asset address
  "ETH",                        // traded asset symbol
  1.5,                          // amount (of asset)
  4713.375,                     // valueUSD
  1.5,                          // baseAmount
  4713.375,                     // quoteAmount
  1713657900,                   // timestamp (Unix)
  "0xTakerAddress",             // taker address
  "0xMakerAddress",             // maker address
  "0xTransactionHash"           // transaction hash
]
```

{% endcode %}

### 📄 Field Descriptions 

| Index | Field         | Type    | Description                              |
| ----- | ------------- | ------- | ---------------------------------------- |
| 0     | `eventId`     | String  | Unique event identifier                  |
| 1     | `orderId`     | Number  | ID of the trade order                    |
| 2     | `base`        | String  | Base token address                       |
| 3     | `quote`       | String  | Quote token address                      |
| 4     | `baseSymbol`  | String  | Symbol of base token                     |
| 5     | `quoteSymbol` | String  | Symbol of quote token                    |
| 6     | `pair`        | String  | Address of the pair contract             |
| 7     | `pairSymbol`  | String  | Symbol of the pair (e.g., `ETH/USDC`)    |
| 8     | `isBid`       | Boolean | `true` if it's a buy, `false` if sell    |
| 9     | `price`       | Number  | Price per unit in quote token            |
| 10    | `account`     | String  | Address of the user initiating the trade |
| 11    | `asset`       | String  | Address of the asset being traded        |
| 12    | `assetSymbol` | String  | Symbol of the traded asset               |
| 13    | `amount`      | Number  | Amount of asset traded                   |
| 14    | `valueUSD`    | Number  | Trade value in USD                       |
| 15    | `baseAmount`  | Number  | Volume in base token                     |
| 16    | `quoteAmount` | Number  | Volume in quote token                    |
| 17    | `timestamp`   | Number  | Unix timestamp of the trade              |
| 18    | `taker`       | String  | Taker address                            |
| 19    | `maker`       | String  | Maker address                            |
| 20    | `txHash`      | String  | Transaction hash                         |