Spire ProtocolSPIRE PROTOCOLDOCS

Overview

A trade reaches Spire Protocol already matched. Price discovery happened somewhere else and we do not touch it. What we take over is everything between the match and final settlement.

Lifecycle of an obligation

  1. Fill. A venue posts a matched fill, signed, referencing both participants and the asset. Nothing has moved yet.
  2. Novation. The trade is torn up and re-signed against Spire Protocol. The buyer owes Spire Protocol, and Spire Protocol owes the seller. Two obligations replace one trade.
  3. Limit check. Each obligation is checked against the participant's position limit, which is a function of the collateral they have staked.
  4. Netting. Inside the settlement window, obligations in the same asset collapse against each other.
  5. Settlement. At the close of the window the net difference settles on chain. What netted out never becomes a transaction.
  6. Default, if it happens. The obligation does not disappear. It is covered by the waterfall, in order, and the counterparty on the other side is paid.

Steps 1 to 3 take one call. Steps 4 and 5 happen on the window clock without the venue doing anything. See Quickstart.

The same lifecycle in one line

Obligation state machine matched novated netted settled Fill received Margin held Window closed Terminal defaulted Routes into the waterfall

defaulted branches off novated and netted. Nothing else is reachable, and no state is ever revisited. Field-level detail is in Data model.

Where the writes happen

This is the part that decides whether a clearing layer is worth having.

EventChain writes
A fill is novatednone
A thousand fills are novatednone
A window closesone per member per asset, against the net
A member defaultsone, plus the auction if it gets that far

A venue doing ten thousand fills an hour in one asset for one member writes to the chain twelve times, once per five minute window, and each write carries only the difference.

What the venue keeps and what it hands over

Stays with the venueMoves to Spire Protocol
Price discovery, matching, the order bookCounterparty risk
The user relationshipCollateral management
Fee policy on its own sideNetting and settlement timing
Listing decisionsDefault handling

What this is not

Reading order

If you are deciding whether this is useful, read Novation and then Netting. Those two carry the argument.

If you are deciding whether it is safe, read Collateral, Default waterfall and Parameters. The third one is where the claims turn into numbers.

If you are integrating, go to Quickstart and keep API reference and Errors open beside it.

If you want to check the claims yourself rather than read about them, go straight to Contracts. Every number on this site is a view call away.

If you are already live and somebody is on call, Operations is the page that should be open at three in the morning.

Last updated 31 August 2026 Docs source on GitHub