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
{
"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
}
]
}