Skip to main content
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.
This endpoint should be restricted in production. It is intended for cron jobs and internal automation, not public access.

Body

application/json
seriesId
string
required

Series ID (uint256) as a decimal or hex string.

Example:

"98765432109876543210"

Response

Signed settlement attestation

success
boolean
seriesId
string
Example:

"98765432109876543210"

resolutionBps
integer

Settlement price in basis points of $1 (0–100).

Example:

73

validUntil
integer

Attestation expiry (Unix seconds).

Example:

1735690500

signature
string

EIP-712 SettlementAttestation signature by the resolution signer.

Example:

"0xabcdef..."

meta
object