---
title: "Confirmation"
url: https://docs.truemarkets.co/api/websocket/institutional/confirmation
description: "Message sent from server containing channels and items the user is currently subscribed to."
---

Docs index: https://docs.truemarkets.co/llms.txt

# Confirmation

True Markets CeFi WebSocket sends these messages to you.

Address: `/v1/cefi/market`

## Servers

- `wss://api.truemarkets.co` (Production, wss)
- `wss://api.uat.truemarkets.co` (Uat, wss)

## Messages

### confirmation

Payload: `ConfirmationPayload`

Example payload:

```json
{
  "timestamp": "string",
  "channel": "WEBSOCKET",
  "update": "SNAPSHOT",
  "status": "INVALID",
  "message": "string",
  "subscriptions": [
    {
      "channel": "INSTRUMENT",
      "item_names": [
        "string"
      ]
    }
  ]
}
```

## Types

```ts
export type ConfirmationMessage = ConfirmationPayload;

export interface ConfirmationPayload {
  /** Server timestamp when the confirmation was generated. */
  timestamp?: string;

  /** Channel this message originated from. */
  channel?: "WEBSOCKET";

  /** Type of update for the current message. */
  update?: "SNAPSHOT" | "UPDATE";

  /** Current status of the websocket connection. */
  status?: "INVALID" | "ERROR" | "UNAUTHORIZED" | "UNAUTHENTICATED" | "AUTHENTICATED";

  /** Optional detail present when a request failed or when one or more requested items could not be subscribed (compare `subscriptions` against what you requested). A message asking you to retry in a few moments indicates a transient condition (e.g. the exchange is still syncing its client catalog after a restart), not a denial — resend the same subscription shortly. */
  message?: string;

  /** List of current subscriptions. For DROPCOPY channel, item_names contains client IDs. HEARTBEAT is listed with empty item_names. */
  subscriptions?: {
    channel?: "INSTRUMENT" | "EBBO" | "DEPTH" | "TRADE" | "AUCTION" | "INDEX" | "DROPCOPY" | "HEARTBEAT";

    /** Subscribed items. For market data channels, these are instrument symbols. For DROPCOPY, these are client IDs. */
    item_names?: string[];
  }[];
}
```