Skip to main content
GET
/
token
/
activate
Activate and retrieve a new API token
curl --request GET \
  --url https://api.example.com/token/activate

Documentation Index

Fetch the complete documentation index at: https://txline-docs.txodds.com/llms.txt

Use this file to discover all available pages before exploring further.

This endpoint activates a user’s subscription and issues a long-lived API token. It requires proof of a successful on-chain subscription payment, which is provided via a transaction signature (‘sig’). The user’s current session JWT is cryptographically verified against a JWT encrypted with a symmetric key and then stored on-chain within that transaction. The key and iv parameters are used to decrypt this on-chain proof. If all validations pass, a new API token is generated, persisted, and returned to the user.

Query Parameters

sig
string
required
The Solana transaction signature that confirms the subscription payment.Example: 5kb6gnsSu1inDF9nCVV3WcgKryyBFGFkrYS28Sp1avS8mq6Xcw6iq3yzkBTjmq8bGptgqYTXPmjyWECzKzUxYG3C
key
string
required
The Base64Url-encoded symmetric key used for payload encryption.
iv
string
required
The Base64Url-encoded initialization vector (IV) for the encryption.

Response

Returns a plain text string containing the newly generated, long-lived API token. Example:
txoracle_api_123abc456def...