Sign in

v1

latestOpenAPI 3.1.02026-07-22163829.6 KB
Settlement

Prepare Settlement Attestation

For an expired series, resolve the price via a tiered waterfall (settled Polymarket outcome if the market has closed, otherwise a time-weighted average price of the YES token over the 30-minute window ending at expiry, sourced from the Polymarket CLOB prices-history endpoint), and return a signed EIP-712 SettlementAttestation that anyone can submit to ConvallaxCore.settle(). If the TWAP window has no price data, the series is escalated to manual review and no attestation is returned.

post/settlement/prepare

Request body

seriesIdstring required

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

Example request

{
  "seriesId": "98765432109876543210"
}

Response

Signed settlement attestation

successtrue
seriesIdstring
resolutionBpsinteger

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

validUntilinteger

Attestation expiry (Unix seconds).

signaturestring

EIP-712 SettlementAttestation signature by the resolution signer.

Example response

{
  "seriesId": "98765432109876543210",
  "resolutionBps": 73,
  "validUntil": 1735690500,
  "signature": "0xabcdef...",
  "meta": {
    "method": "twap",
    "twap": 0.732145,
    "pointCount": 28,
    "yesPrice": 1,
    "windowStart": 1735687800,
    "windowEnd": 1735689600
  }
}