Read the public product Points preview policy and daily reset.
GET /api/v1/points/program. Read the public product Points preview policy and daily reset.
Request
GET /api/v1/points/program
The schema permits anonymous access.
Parameters
| Name | In | Type | Required | Constraints | Description |
|---|---|---|---|---|---|
X-Request-Id | header | string | No | min length: 8; max length: 128; pattern: ^[A-Za-z0-9._:-]+$ | Optional client correlation identifier. The server always generates a separate authoritative request ID and retains a valid supplied value only as secondary audit correlation metadata. |
cURL
curl --fail-with-body --silent --show-error \
--request GET \
--url "https://launch-api.supanova.app/api/v1/points/program"Responses
200
Versioned, off-ledger Points policy.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
meta | object · Schema 1 | Yes | — | — |
reset | object · Schema 2 | Yes | — | — |
status | "preview" | Yes | — | — |
tasks | array of exactly one variant · Schema 3 | Yes | min items: 3; max items: 3 | — |
tiers | array of object · Schema 4 | Yes | min items: 5; max items: 5 | — |
Additional fields are not allowed.
429
The caller exceeded an IP or principal request budget.
| Header | Type | Description |
|---|---|---|
Retry-After | integer | Whole seconds to wait before retrying a rate-limited request. |
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.
503
A durable, reviewed Supanova Points policy engine is not configured.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.
default
Machine-readable API error. The HTTP status identifies the error class.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.
Nested schemas
Field links above lead to the complete nested object, array, and variant definitions below. Required fields are scoped to their containing object.
Schema 1
Response 200.meta
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
asOf | string | Yes | format: date-time; pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ | — |
authority | "supanova-product" | Yes | — | — |
dataMode | "simulated" | Yes | — | — |
disclaimer | string | Yes | min length: 1; max length: 1024 | — |
ledgerEffect | "none" | Yes | — | — |
policyVersion | "points-preview-2026-08-07.1" | Yes | — | — |
Additional fields are not allowed.
Schema 2
Response 200.reset
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
cadence | "daily" | Yes | — | — |
nextAt | string | Yes | format: date-time; pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ | — |
timezone | "UTC" | Yes | — | — |
Additional fields are not allowed.
Schema 3
Response 200.tasks
Type: array of exactly one variant.
min items: 3; max items: 3
Array items: exactly one variant · Schema 5.
Schema 4
Response 200.tiers
Type: array of object.
min items: 5; max items: 5
Array items: object · Schema 6.
Schema 5
Response 200.tasks item
Type: exactly one variant.
Exactly one of these variants must match:
Schema 6
Response 200.tiers item
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
description | string | Yes | min length: 1; max length: 500 | — |
id | string | Yes | allowed: "stargazer", "pathfinder", "voyager", "luminary", "nova_prime" | — |
minimumActiveWeeks | integer | Yes | minimum: 0; maximum: 52 | — |
minimumPoints | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})$ | — |
name | string | Yes | allowed: "Stargazer", "Pathfinder", "Voyager", "Luminary", "Nova Prime" | — |
Additional fields are not allowed.
Schema 7
Response 200.tasks item variant 1
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
awardPoints | "5" | Yes | — | — |
cadence | "once_per_utc_day" | Yes | — | — |
description | string | Yes | min length: 1; max length: 500 | — |
eligibleActions | array of unspecified · Schema 10 | Yes | min items: 3; max items: 3 | — |
id | "daily_transaction" | Yes | — | — |
title | "Daily Transaction" | Yes | — | — |
Additional fields are not allowed.
Schema 8
Response 200.tasks item variant 2
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
awardPoints | "2" | Yes | — | — |
cadence | "once_per_utc_day" | Yes | — | — |
description | string | Yes | min length: 1; max length: 500 | — |
id | "daily_swap" | Yes | — | — |
threshold | object · Schema 11 | Yes | — | — |
title | "Daily Swap" | Yes | — | — |
Additional fields are not allowed.
Schema 9
Response 200.tasks item variant 3
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
awardPoints | "10" | Yes | — | — |
cadence | "once_per_utc_day" | Yes | — | — |
description | string | Yes | min length: 1; max length: 500 | — |
downstreamPointsShareBps | "1000" | Yes | — | — |
id | "daily_referral" | Yes | — | — |
qualification | object · Schema 12 | Yes | — | — |
title | "Daily Referral" | Yes | — | — |
Additional fields are not allowed.
Schema 10
Response 200.tasks item variant 1.eligibleActions
Type: array of unspecified.
min items: 3; max items: 3
Tuple positions (in order):
"deposit"."withdrawal"."swap".
Schema 11
Response 200.tasks item variant 2.threshold
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
currency | "USD" | Yes | — | — |
operator | "greater_than" | Yes | — | — |
value | "10" | Yes | — | — |
Additional fields are not allowed.
Schema 12
Response 200.tasks item variant 3.qualification
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
depositThreshold | object · Schema 13 | Yes | — | — |
signup | "verified_product_profile" | Yes | — | — |
Additional fields are not allowed.
Schema 13
Response 200.tasks item variant 3.qualification.depositThreshold
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
currency | "USD" | Yes | — | — |
operator | "greater_than_or_equal" | Yes | — | — |
value | "10" | Yes | — | — |
valuationAuthority | "server_reference_rate_at_confirmed_finality" | Yes | — | — |
Additional fields are not allowed.
Source contract
This page is generated from the checked-in customer OpenAPI snapshot. Download JSON, download YAML, or compare the live API reference. Snapshot provenance records the retrieval date and checksum.