Skip to main content

API reference

Public read models and ciphertext-only private relay for Layrs generation-v2.

Base URL: https://api.layrs.xyz · Version: 1.0.0

All read models and the ciphertext-only private relay are served from this single public base. Endpoints are grouped below by area. This reference is generated from the published OpenAPI specification.

System

MethodEndpointParameters
GET/healthz

Attestation & privacy

MethodEndpointParameters
GET/v1/attestationnonce (query, required)
GET/v1/privacy/release

Markets

MethodEndpointParameters
GET/v1/markets
GET/v1/markets/{marketId}None (None)
GET/v1/resolutions/{marketId}None (None)

Vaults

MethodEndpointParameters
GET/v1/vaults

Private trading

MethodEndpointParameters
POST/v1/private/sessionsNone (None)
POST/v1/private/relayNone (None)
POST/v1/realtime/token

Funding

MethodEndpointParameters
POST/v1/funding/depositsNone (None)
GET/v1/funding/deposits/{depositId}depositId (path, required)
POST/v1/funding/withdrawalsNone (None)
GET/v1/funding/withdrawals/{withdrawalId}withdrawalId (path, required)

Milestone / adoption

MethodEndpointParameters
GET/v1/milestone/adoption
GET/v1/milestone/adoption.csv

Bootstrap

MethodEndpointParameters
POST/v1/bootstrap/{executionId}/executeNone (None), executionId (path, required)
GET/v1/bootstrap/{executionId}executionId (path, required)

Notable behaviors

  • GET /v1/attestation requires a nonce. Without it, the endpoint returns ATTESTATION_NONCE_REQUIRED. The nonce binds the returned attestation document to your request and prevents replay. See Attestation.
  • POST /v1/private/relay is ciphertext-only. The client seals a signed order to the enclave's transport public key before submitting; plaintext never reaches an API container, database, or log.
  • Markets are read models. GET /v1/markets returns per-market privacy fields including hiddenBook, aggregateBucketMs, and attestedPcr0Sha384 — the enclave measurement bound to that market.