# Subscribe (Trade)

`WS` `request · cmd 16`

Subscribe trade-gateway topics. Topic `private` delivers order/execution notifications. The response reports success / fail / current topics.

```protobuf
message Sub {
  repeated string topics = 1;
}

message SubResponse {
  repeated string success = 1;
  repeated Fail fail = 2;
  repeated string current = 3;
}
```

## Request Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `topics` | string[] | No | Topics to subscribe |

## Response Fields

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `success` | string[] | No | Success topics |
| `fail` | object[] | No | Failed topics |
| `└ topic` | string | No | Topic |
| `└ reason` | string | No | Failure reason |
| `current` | string[] | No | Current subscriptions after subscribe |

## Response JSON Example

```json
{
  "success": [
    "private"
  ],
  "fail": [],
  "current": [
    "private"
  ]
}
```
