post/v1/trade-engine/settlement
The authoritative TradeValue/settlement computation — offer-service and trade-session-service call this rather than reimplementing the formula (TradeValue = OriginalPrice + RequestedAmount - WillingToPay per listing). All listings in a trade must share one currency; cross-currency settlement-of-record is not yet supported and is rejected outright.
Request body
| Field | Type | Required |
|---|
| listingIdsA | string[] | yes |
| listingIdsB | string[] | yes |
| extraAmountA | number | — |
| extraAmountB | number | — |
Response (201)
| Field | Type | Required |
|---|
| currency | string | — |
| sideAValue | number | — |
| sideBValue | number | — |
| difference | number | — |
| owingSide | A | B | | — |