Prepare Settlement Attestation
Settlement
Prepare Settlement
Compute the TWAP resolution price for an expired option series and return a signed EIP-712 settlement attestation.
POST
Prepare Settlement Attestation
Compute the resolution price for an expired option series and return a signed settlement attestation. The relay reads on-chain series metadata and resolves the price via a tiered waterfall: if the underlying Polymarket market has closed it uses the settled YES outcome, otherwise it computes a time-weighted average (TWAP) of the YES token’s price from the Polymarket CLOB
prices-history endpoint over the 30-minute window ending at expiry, then signs an EIP-712 SettlementAttestation with the resolution signer’s key. If that window has no price data, the relay declines to sign and the series is escalated to manual review.
The returned attestation can be relayed on-chain by anyone via settleWithAttestation() on ConvallaxCore.
Body
application/json
Series ID (uint256) as a decimal or hex string.
Example:
"98765432109876543210"
Response
Signed settlement attestation
Example:
"98765432109876543210"
Settlement price in basis points of $1 (0–100).
Example:
73
Attestation expiry (Unix seconds).
Example:
1735690500
EIP-712 SettlementAttestation signature by the resolution signer.
Example:
"0xabcdef..."
