Transaction Endpoint

Route

POST /v1/transactions

Minimal request:

{
  "partner_id": "partner_1",
  "quote_id": "returned_quote_reference",
  "asset": "BTC",
  "amount": "0.5",
  "direction": "Long",
  "premium_collected": "9.5"
}

Contract

The transaction contract is deliberately simple:

1. the partner confirms which quote the customer accepted and repeats the asset, amount, and direction,
2. Slice checks the acceptance against the locked quote terms,
3. the transaction is recorded under the partner boundary,
4. reporting can read back the customer-facing terms and lifecycle status.

Response Excerpt

The response returns the created transaction plus enough state for partner reporting:

{
  "transaction_id": "0cb86b65-ae96-4de8-b9b2-6412cb1f0b36",
  "partner_id": "partner_1",
  "asset": "BTC",
  "amount": "0.5",
  "direction": "Long",
  "premium_collected": "9.5",
  "status": "Pooled",
  "quote_id": "9f6f2f7a-4ff8-4d9d-8fbf-6f0dc338b6ab",
  "created_at": "2026-03-27T08:00:02Z",
  "updated_at": "2026-03-27T08:00:02Z"
}

Next step

Once the transaction is accepted, reporting routes provide quote evidence, settlement visibility, and payout lifecycle state.