Get Snaxpot Epoch

Retrieve information about a specific Snaxpot lottery epoch, including epoch metadata and on-chain VRF transaction hashes for verifying the randomness source.

Endpoint

POST https://papi.synthetix.io/v1/info

Request

Request Format

{
  "params": {
    "action": "getSnaxpotEpoch",
    "epochId": "42"
  }
}

Request Parameters

Parameter	Type	Required	Description
`params.action`	string	Yes	Must be `"getSnaxpotEpoch"`
`params.epochId`	string	Yes	The epoch ID to retrieve (uint64 as string)

No authentication required.

Response

Success Response

{
  "status": "ok",
  "response": {
    "epochId": "42",
    "startTime": "2026-05-01T00:00:00Z",
    "endTime": "2026-05-08T00:00:00Z",
    "drawTime": "2026-05-08T12:00:00Z",
    "status": "completed",
    "prizePool": "10000.00",
    "vrfDrawTxHash": "0xabc123def456abc123def456abc123def456abc123def456abc123def456abc1",
    "vrfSeedTxHash": "0x111222333444555666777888999aaabbbccc000ddd111eee222fff333444555"
  },
  "request_id": "5ccf215d37e3ae6d"
}

Response Fields

Field	Type	Description
`epochId`	string	The epoch identifier
`startTime`	string	Epoch start datetime (RFC3339)
`endTime`	string	Epoch end datetime (RFC3339)
`drawTime`	string	Draw datetime (RFC3339)
`status`	string	Epoch status (e.g., `"active"`, `"completed"`)
`prizePool`	string	Total prize pool in USDT equivalent
`vrfDrawTxHash`	string \| null	On-chain transaction hash for the VRF draw event. `null` until the draw transaction is confirmed on-chain, or for historical epochs that predate VRF tracking
`vrfSeedTxHash`	string \| null	On-chain transaction hash for the VRF seed event. `null` until the seed transaction is confirmed on-chain, or for historical epochs that predate VRF tracking

vrfDrawTxHash and vrfSeedTxHash enable integrators to verify the randomness source directly on the blockchain. Use these hashes with a block explorer to inspect the on-chain VRF draw and seed events for the epoch.

Error Response

{
  "status": "error",
  "error": {
    "code": "NOT_FOUND",
    "message": "Epoch not found"
  },
  "request_id": "5ccf215d37e3ae6d"
}

:::info Rate Limits The Synthetix API enforces rate limits to ensure fair usage and system stability:

Order Placement: 100 orders per second per subaccount
WebSocket Connections: 100 connections per IP address
WebSocket Subscriptions: 1000 subscriptions per IP address

See Rate Limits for detailed information and best practices. :::

Implementation Notes

vrfDrawTxHash and vrfSeedTxHash are null when the corresponding on-chain event has not yet occurred, or when historical epoch data predates VRF hash tracking.
Both fields are additive — existing integrations continue to work without modification.

Error Handling

Error Code	Description	Retryable
`UNAUTHORIZED`	EIP-712 signature validation failed	No
`VALIDATION_ERROR`	Request validation failed	No
`MISSING_REQUIRED_FIELD`	Required field is missing	No
`INVALID_FORMAT`	Field format is invalid	No
`INVALID_VALUE`	Invalid parameter value	No
`RATE_LIMIT_EXCEEDED`	Too many requests in time window	Yes
`INSUFFICIENT_MARGIN`	Not enough margin for trade	No
`ORDER_NOT_FOUND`	Order does not exist	No
`OPERATION_TIMEOUT`	Operation timed out	Yes

Get Snaxpot Epoch Tickets — Query lottery tickets for an epoch range (authenticated)
Snaxpot — Overview of Snaxpot actions