Tradeweb · Schema

Tradeweb Trade

Schema for an electronically executed trade on the Tradeweb platform across fixed income, derivatives, ETF, and money market products.

Electronic TradingFinancial MarketsFixed IncomeMarket DataOTC Trading

Properties

Name	Type	Description
tradeId	string	Unique Tradeweb trade identifier.
assetClass	string	Asset class of the traded instrument.
instrument	string	Instrument identifier or description.
cusip	string	CUSIP identifier for US instruments.
isin	string	ISIN identifier for international instruments.
tradeDate	string	Date the trade was executed.
settlementDate	string	Contractual settlement date.
quantity	number	Trade notional quantity.
currency	string	ISO 4217 currency code.
price	number	Execution price.
yield	number	Yield at execution for fixed income instruments.
executionType	string	How the trade was executed on Tradeweb.
counterpartyId	string	Identifier of the dealer counterparty.
side	string	Trade direction from the client perspective.
status	string	Current lifecycle status of the trade.
mifidiiReported	boolean	Whether the trade has been reported via MiFID II APA.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12",
  "$id": "https://raw.githubusercontent.com/api-evangelist/tradeweb/main/json-schema/tradeweb-trade-schema.json",
  "title": "Tradeweb Trade",
  "description": "Schema for an electronically executed trade on the Tradeweb platform across fixed income, derivatives, ETF, and money market products.",
  "type": "object",
  "properties": {
    "tradeId": {
      "type": "string",
      "description": "Unique Tradeweb trade identifier.",
      "example": "TW-20260503-1234567"
    },
    "assetClass": {
      "type": "string",
      "description": "Asset class of the traded instrument.",
      "enum": [
        "Government Bonds",
        "Corporate Bonds",
        "ETFs",
        "Interest Rate Swaps",
        "Credit Default Swaps",
        "Repo",
        "Money Market",
        "Municipal Bonds",
        "Agency Bonds"
      ],
      "example": "Government Bonds"
    },
    "instrument": {
      "type": "string",
      "description": "Instrument identifier or description.",
      "example": "US Treasury 4.5% 2034"
    },
    "cusip": {
      "type": "string",
      "description": "CUSIP identifier for US instruments.",
      "pattern": "^[A-Z0-9]{9}$",
      "example": "912828YK0"
    },
    "isin": {
      "type": "string",
      "description": "ISIN identifier for international instruments.",
      "pattern": "^[A-Z]{2}[A-Z0-9]{10}$",
      "example": "US912828YK03"
    },
    "tradeDate": {
      "type": "string",
      "format": "date",
      "description": "Date the trade was executed.",
      "example": "2026-05-03"
    },
    "settlementDate": {
      "type": "string",
      "format": "date",
      "description": "Contractual settlement date.",
      "example": "2026-05-05"
    },
    "quantity": {
      "type": "number",
      "description": "Trade notional quantity.",
      "example": 10000000
    },
    "currency": {
      "type": "string",
      "description": "ISO 4217 currency code.",
      "example": "USD"
    },
    "price": {
      "type": "number",
      "description": "Execution price.",
      "example": 98.5
    },
    "yield": {
      "type": "number",
      "description": "Yield at execution for fixed income instruments.",
      "example": 4.72
    },
    "executionType": {
      "type": "string",
      "description": "How the trade was executed on Tradeweb.",
      "enum": ["RFQ", "ClickToTrade", "AiEX", "StreamingPrice"],
      "example": "RFQ"
    },
    "counterpartyId": {
      "type": "string",
      "description": "Identifier of the dealer counterparty.",
      "example": "DEALER-GS-001"
    },
    "side": {
      "type": "string",
      "enum": ["Buy", "Sell"],
      "description": "Trade direction from the client perspective.",
      "example": "Buy"
    },
    "status": {
      "type": "string",
      "enum": ["Executed", "Cancelled", "Pending", "Reported"],
      "description": "Current lifecycle status of the trade.",
      "example": "Executed"
    },
    "mifidiiReported": {
      "type": "boolean",
      "description": "Whether the trade has been reported via MiFID II APA.",
      "example": true
    }
  },
  "required": ["tradeId", "assetClass", "instrument", "tradeDate", "quantity", "currency", "executionType", "side", "status"]
}