tipInfo

tipInfo — Discover TTL classes, limits, and quota

get

/lightspeed/tipinfo

Returns the TTL ladder the edge serves, whether each class can be issued right now, the maximum count per fetch, the minimum tip in lamports for a dynamic address, and the current fetch quota for this API key (or the anonymous bucket).

?ttl=N on /lightspeed/fetchtipaddress snaps up to the smallest ttl_seconds ≥ N in this ladder. expires_at_if_fetched_now shows what fetchtipaddress would return this second — it advances as the open batch's window ends and the next opens.

Authorizations

AuthorizationstringOptional

Pass Authorization: <api-key> on each request.

Responses

200

TTL ladder and quota for this edge.

application/json

default_ttl_secondsinteger · int64Required

Used when /lightspeed/fetchtipaddress is called with no ttl parameter.

max_ttl_secondsinteger · int64Required

Ceiling for the ttl query on /lightspeed/fetchtipaddress. Above this returns 400 ttl_too_long.

max_countinteger · int32Required

Ceiling for the count query on /lightspeed/fetchtipaddress.

min_lamportsinteger · int64Required

Rent-exempt minimum for a dynamic tip address. A route's minimum_lamports may be higher.

Example: 890880

served_bystringRequired

Informational — which edge answered this call.

Example: ams1

429

Anonymous quota exceeded (no Authorization header).

application/json

500

Unexpected server error.

application/json

get/lightspeed/tipinfo

curl -X GET https://basic.swqos.solanavibestation.com/lightspeed/tipinfo

{
  "ttl_classes": [
    {
      "ttl_seconds": 3600,
      "available": true,
      "expires_at_if_fetched_now": 1756000000
    },
    {
      "ttl_seconds": 86400,
      "available": true,
      "expires_at_if_fetched_now": 1756086000
    },
    {
      "ttl_seconds": 172800,
      "available": false,
      "expires_at_if_fetched_now": null
    }
  ],
  "default_ttl_seconds": 3600,
  "max_ttl_seconds": 172800,
  "max_count": 16,
  "min_lamports": 890880,
  "quota": {
    "fetch_rate_per_second": 5,
    "fetch_burst": 20,
    "fetch_daily_cap": null
  },
  "served_by": "ams1"
}