Tradeweb · JSON Structure

Tradeweb Trade Structure

JSON structure documentation for an electronically executed trade on the Tradeweb platform.

Type: object Properties: 0
Electronic TradingFinancial MarketsFixed IncomeMarket DataOTC Trading

Tradeweb Trade Structure is a JSON Structure definition published by Tradeweb.

Meta-schema:

JSON Structure

tradeweb-trade-structure.json Raw ↑
{
  "title": "Tradeweb Trade Structure",
  "description": "JSON structure documentation for an electronically executed trade on the Tradeweb platform.",
  "type": "object",
  "fields": [
    {
      "name": "tradeId",
      "type": "string",
      "required": true,
      "description": "Unique Tradeweb trade identifier.",
      "example": "TW-20260503-1234567"
    },
    {
      "name": "assetClass",
      "type": "string",
      "required": true,
      "description": "Asset class of the traded instrument.",
      "example": "Government Bonds"
    },
    {
      "name": "instrument",
      "type": "string",
      "required": true,
      "description": "Instrument identifier or name.",
      "example": "US Treasury 4.5% 2034"
    },
    {
      "name": "cusip",
      "type": "string",
      "required": false,
      "description": "9-character CUSIP identifier for US instruments.",
      "example": "912828YK0"
    },
    {
      "name": "isin",
      "type": "string",
      "required": false,
      "description": "12-character ISIN identifier.",
      "example": "US912828YK03"
    },
    {
      "name": "tradeDate",
      "type": "string",
      "required": true,
      "description": "Execution date in ISO 8601 format.",
      "example": "2026-05-03"
    },
    {
      "name": "settlementDate",
      "type": "string",
      "required": false,
      "description": "Contractual settlement date in ISO 8601 format.",
      "example": "2026-05-05"
    },
    {
      "name": "quantity",
      "type": "number",
      "required": true,
      "description": "Trade notional quantity.",
      "example": 10000000
    },
    {
      "name": "currency",
      "type": "string",
      "required": true,
      "description": "ISO 4217 currency code.",
      "example": "USD"
    },
    {
      "name": "price",
      "type": "number",
      "required": false,
      "description": "Execution price (percent of par for bonds).",
      "example": 98.5
    },
    {
      "name": "yield",
      "type": "number",
      "required": false,
      "description": "Yield at execution for fixed income.",
      "example": 4.72
    },
    {
      "name": "executionType",
      "type": "string",
      "required": true,
      "description": "Execution mechanism: RFQ, ClickToTrade, AiEX, or StreamingPrice.",
      "example": "RFQ"
    },
    {
      "name": "counterpartyId",
      "type": "string",
      "required": false,
      "description": "Dealer counterparty identifier.",
      "example": "DEALER-GS-001"
    },
    {
      "name": "side",
      "type": "string",
      "required": true,
      "description": "Buy or Sell from the client perspective.",
      "example": "Buy"
    },
    {
      "name": "status",
      "type": "string",
      "required": true,
      "description": "Trade lifecycle status: Executed, Cancelled, Pending, Reported.",
      "example": "Executed"
    },
    {
      "name": "mifidiiReported",
      "type": "boolean",
      "required": false,
      "description": "Whether reported via MiFID II APA.",
      "example": true
    }
  ]
}