trading-venue.trade.final
A trade's delivery completed on chain: the venue's Delivered log, emitted when the holding period is over and the legs have moved. A trade is final only then, never when its settlement transaction is merely queued. Carries the log's coordinate; read the trade through the venue API.
Delivery contract
| Field | Value |
|---|---|
| Event type | trading-venue.trade.final |
| Version | 1 |
| Lifecycle state | final |
| Counter-signed receipts | No event-specific advice |
| SDK type | Webhook.TradingVenueTradeFinalV1 |
The receipt recommendation does not change delivery behavior. DALP waits for a counter-signed receipt only if the webhook endpoint's counterSignedReceipts value is true when DALP queues the delivery. When the value is false, a normal 2xx response completes the delivery.
Related references:
idxr_trading_venue
Payload schema
The schema and examples describe the full payload. Thin delivery omits personal data fields. Use the payload-shape guidance to choose the endpoint configuration.
{
"type": "object",
"properties": {
"venueAddress": {
"type": "string",
"minLength": 42,
"maxLength": 42,
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "A valid Ethereum address (42 characters, starting with 0x)",
"examples": ["0x71C7656EC7ab88b098defB751B7401B5f6d8976F"]
},
"marketId": {
"type": "string",
"pattern": "^0x[0-9a-f]{64}$"
},
"venueTradeId": {
"type": "string",
"pattern": "^0x[0-9a-f]{64}$"
},
"chainId": {
"type": "integer",
"exclusiveMinimum": 0
},
"transactionHash": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{64}$"
},
"blockNumber": {
"type": "integer"
},
"logIndex": {
"type": "integer"
}
},
"required": ["venueAddress", "marketId", "venueTradeId", "chainId", "transactionHash", "blockNumber", "logIndex"],
"additionalProperties": true
}TypeScript SDK example
Use the request's raw body and headers with your endpoint's webhook secret. This handler illustrates verification and event selection. Before writing downstream state, deduplicate deliveries by evt_id and recognize replayed outcomes by their domain identifiers.
const result = await verifyWebhook({
rawBody,
headers,
secret: process.env.DALP_WEBHOOK_SECRET!,
});
if (!result.ok) {
throw new Error(`Webhook verification failed: ${result.code}`);
}
if (result.event.type === "trading-venue.trade.final") {
const event: Webhook.Event<"trading-venue.trade.final"> = result.event;
console.log(event.payload);
}HTTP delivery example
This illustrative request shows the delivery shape. Its timestamp and signature are placeholders; a verifier rejects them. Use a signed platform delivery to verify your endpoint.
curl -X POST https://consumer.example.com/dalp/webhooks \
-H "content-type: application/json" \
-H "webhook-id: evt_8f398bdb4e612221f4aa0dbecddc036e" \
-H "webhook-timestamp: 1778112000" \
-H "webhook-signature: v1,docs-example-signature" \
--data '{"evt_id":"evt_8f398bdb4e612221f4aa0dbecddc036e","source_id":"example:trading-venue.trade.final@1:0","lifecycle_state":"final","payload":{"venueAddress":"0x9999999999999999999999999999999999999999","marketId":"0x1111111111111111111111111111111111111111111111111111111111111111","venueTradeId":"0x2222222222222222222222222222222222222222222222222222222222222222","chainId":537001,"transactionHash":"0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","blockNumber":1204311,"logIndex":7},"related":{"idxr_trading_venue":"idxr_trading_venue_example"},"type":"trading-venue.trade.final","version":1,"request":{"idempotency_key":"idem_01JZP7R5W8M9N0P1Q2R3S4T5"}}'Version and manifest
This page documents version 1 of trading-venue.trade.final. This event type is not deprecated. The DALP events manifest contains the machine-readable AsyncAPI entry.
trading-venue.trade-settled.retracted
A settled trade was busted after its settlement event. Sent only once the reversal is complete on chain, through every reversal transfer of the bust or the venue's own undo of the trade, never while a reversal is only queued, after it reverts, or when it does not settle in time. supersedes names the trading-venue.trade-settled.final event when this endpoint received it.
trading-venue.trade.retracted
A trade was undone by an approved trade bust and the reversal landed on chain: the venue's DeliveryUndone log with the bust reason. Its trading-venue.trade.final event no longer stands. Not emitted when a bust is only queued.