fetchTipAddress

fetchTipAddress — Issue one or more dynamic Lightspeed tip addresses

get

/lightspeed/fetchtipaddress

Returns one or more dynamic tip addresses for use in a Lightspeed sendTransaction submission.

Response shape

• No query parameters → the legacy single-address shape: { address, validity_duration_seconds, expires_at }.

• Any query parameter present → the full batch shape: { addresses[], ttl_seconds, requested_ttl_seconds, expires_at, min_lamports, issued_by }.

The addresses array may be shorter than count if this edge's slice of the batch ran low mid-request; retry for the rest.

expires_at is absolute and authoritative — always prefer it over ttl_seconds. All addresses in a batch expire together, so expires_at may exceed "now + ttl" by up to one batch window.

Authorizations

AuthorizationstringOptional

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

Query parameters

ttlinteger · int64 · min: 1Optional

Desired lifetime in seconds. Snapped up to the smallest TTL class this edge serves. Above max_ttl_seconds returns 400 ttl_too_long.

Example: 900

countinteger · int32 · min: 1Optional

Number of addresses to issue, 1..=max_count.

Default: 1Example: 4

Responses

200

Success. Response shape depends on whether any query parameter was passed.

application/json

or

400

Bad request. Possible bodies:

• {"error":"ttl_too_long","max_ttl_seconds":86400} — ttl above the max this edge serves.
• {"error":"count_out_of_range","max_count":16} — count is 0 or above the max.
• {"error":"ttl must be an integer number of seconds"} — unparsable ttl.

application/json

429

Quota exceeded for this API key.

application/json

503

Temporarily unavailable. This is normal during batch rotation and typically clears within minutes.

application/json

get/lightspeed/fetchtipaddress

curl -X GET 'https://basic.swqos.solanavibestation.com/lightspeed/fetchtipaddress?ttl=900&count=4' \
  -H "Authorization: your-api-key-here"

{
  "address": "7xKq3...",
  "validity_duration_seconds": 3600,
  "expires_at": 1755821400
}