{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "#/components/schemas/Transaction",
"title": "Transaction",
"type": "object",
"description": "A portfolio transaction",
"properties": {
"transactionId": {
"type": "string",
"description": "Unique transaction identifier",
"example": "TXN-20260415-78901"
},
"transactionType": {
"type": "string",
"description": "Transaction type",
"example": "TRADE"
},
"tradeDate": {
"type": "string",
"format": "date",
"description": "Trade execution date",
"example": "2026-04-15"
},
"settlementDate": {
"type": "string",
"format": "date",
"description": "Expected or actual settlement date",
"example": "2026-04-17"
},
"settlementStatus": {
"type": "string",
"description": "Settlement status",
"enum": [
"PENDING",
"SETTLED",
"FAILED"
],
"example": "SETTLED"
},
"securityId": {
"type": "string",
"description": "Security identifier",
"example": "US0378331005"
},
"securityName": {
"type": "string",
"description": "Security name",
"example": "Apple Inc"
},
"quantity": {
"type": "number",
"format": "double",
"description": "Transaction quantity (positive for buy, negative for sell)",
"example": 500
},
"price": {
"type": "number",
"format": "double",
"description": "Transaction price per unit",
"example": 213.5
},
"netAmount": {
"type": "number",
"format": "double",
"description": "Net transaction amount after commissions and fees",
"example": 106750.0
},
"currency": {
"type": "string",
"description": "Transaction currency",
"example": "USD"
}
}
}