Printr Staking
Stake a Printr launch's tokens from its wallets, list the positions and claim their rewards.
For launches on Printr (Solana), launch wallets can lock tokens in Printr staking positions and earn rewards in the quote token and in the launched token. Each wallet signs its own transaction; results are reported per wallet, so a call can partly succeed.
Create and claim calls take at most 50 wallets or claims per request.
The Staking position object
A Printr staking position held by a launch wallet, with its rewards when requested.
Attributes
-
infoobjectThe position.Child attributes 12
-
ownerstringWallet that owns the position. -
positionstringPosition account, as a CAIP-10 identifier. -
lock_periodenumLock period of the position.Possible valuesSTAKING_LOCK_PERIOD_SEVEN_DAYSSTAKING_LOCK_PERIOD_FOURTEEN_DAYSSTAKING_LOCK_PERIOD_THIRTY_DAYSSTAKING_LOCK_PERIOD_SIXTY_DAYSSTAKING_LOCK_PERIOD_NINETY_DAYSSTAKING_LOCK_PERIOD_ONE_HUNDRED_EIGHTY_DAYS -
stakedobjectAmount staked.Child attributes 5
-
assetobjectAsset reference.Child attributes 1
-
accountstringAsset account.
-
-
decimalsintegerToken decimals. -
atomicstringAmount in atomic units. -
displaystringAmount formatted for display.
-
-
created_atstringCreation time, ISO 8601. -
unlocks_atstringUnlock time, ISO 8601. -
was_closedbooleanWhether the position has been closed.
-
-
claimable_quote_rewardsobject | nullQuote rewards claimable now.Child attributes 5
-
assetobjectAsset reference.Child attributes 1
-
accountstringAsset account.
-
-
decimalsintegerToken decimals. -
atomicstringAmount in atomic units. -
displaystringAmount formatted for display.
-
-
claimable_telecoin_rewardsobject | nullToken rewards claimable now.Child attributes 5
-
assetobjectAsset reference.Child attributes 1
-
accountstringAsset account.
-
-
decimalsintegerToken decimals. -
atomicstringAmount in atomic units. -
displaystringAmount formatted for display.
-
-
claimed_quote_rewardsobject | nullQuote rewards already claimed.Child attributes 5
-
assetobjectAsset reference.Child attributes 1
-
accountstringAsset account.
-
-
decimalsintegerToken decimals. -
atomicstringAmount in atomic units. -
displaystringAmount formatted for display.
-
-
claimed_telecoin_rewardsobject | nullToken rewards already claimed.Child attributes 5
-
assetobjectAsset reference.Child attributes 1
-
accountstringAsset account.
-
-
decimalsintegerToken decimals. -
atomicstringAmount in atomic units. -
displaystringAmount formatted for display.
-
Create staking positions
/launch/printr/staking/create-position/{launch_id} Stakes the same token amount from each selected launch wallet for the chosen lock period.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Refused with
403 read_only_token. - Retry
- Check before retrying Each call opens new positions from every selected wallet. Before retrying, call List staking positions for the same wallets and retry only the wallets that have no new position.
Path parameters
-
launch_idstring RequiredLaunch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (101Solana,201BSC,202Base,204Ethereum).Example101000000004217
Body parameters application/json
-
lock_periodenum RequiredHow long the tokens stay locked.Possible valuesSTAKING_LOCK_PERIOD_SEVEN_DAYSSTAKING_LOCK_PERIOD_FOURTEEN_DAYSSTAKING_LOCK_PERIOD_THIRTY_DAYSSTAKING_LOCK_PERIOD_SIXTY_DAYSSTAKING_LOCK_PERIOD_NINETY_DAYSSTAKING_LOCK_PERIOD_ONE_HUNDRED_EIGHTY_DAYS -
amountinteger RequiredTokens to stake per wallet, atomic units. Must be greater than 0. -
walletsarray<string> OptionalLaunch wallets to stake from. Omit for all launch wallets.
Returns 200 OK · application/json
-
successbooleantruewhen at least one position was created. -
createdintegerNumber of wallets whose position was created. -
totalintegerNumber of wallets attempted. -
resultsarray<object>One entry per wallet.Child attributes 4
-
pubkeystringWallet. -
successbooleanWhether this wallet staked. -
signaturestringTransaction signature. -
errorstringWhy this wallet failed.
-
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | launch_id is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it. |
| 404 | not_found | No launch with this ID belongs to the license in your token. Check the launch ID and that your token is upgraded onto the license that owns the launch. |
| 400 | bad_request | amount is 0. Send an amount greater than 0, in atomic units. |
| 400 | bad_request | More than 50 wallets are selected, including when wallets is omitted and the launch has more than 50 wallets. Pass wallets with at most 50 addresses per request. |
| 404 | not_found | None of wallets belongs to the launch. Addresses outside the launch are dropped silently as long as one matches. Pass addresses of the launch's own wallets, or omit wallets to use all of them. |
| 400 | unsupported_chain | The launch is not on Solana. The body adds chain. Call it only for Solana launches (IDs starting with 101). |
| 400 | — | The body is missing, is not valid JSON, lacks lock_period or amount, has an unknown lock_period, or is sent without Content-Type: application/json. The HTTP framework answers before the handler runs (before launch_id is checked) with a plain-text body, not the JSON error object. Send a JSON body with Content-Type: application/json that matches the documented fields. |
| 500 | internal_error | The launch is still a draft: the token does not exist on chain yet. Launch the token first with Launch a token. |
| 500 | internal_error | Printr's token API failed or does not know the launch's mint, for example because the launch is not a Printr launch. Check that the launch is a Printr launch, then retry in a few seconds. |
| 500 | internal_error | Printr's staking API refused or failed for every selected wallet, so nothing was sent. The per-wallet reasons are not returned. Retry later; nothing was sent, so a retry cannot stake twice. |
Also the common errors: 401 for a missing or expired session or a base token (license_required), 403 read_only_token and 429 when rate limited.
Web client proxima.launch.printrStaking.createPosition(launchId, request) src/lib/proxima/endpoints/launch/printr-staking.ts
List staking positions
/launch/printr/staking/list-positions/{launch_id} Returns the staking positions held by the launch's wallets.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Refused with
403 read_only_token. - Retry
- Safe to retry A read:
POSTonly carries the filter.
A POST so the wallet filter can travel in the body; the client sends {} when there is no filter.
Path parameters
-
launch_idstring RequiredLaunch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (101Solana,201BSC,202Base,204Ethereum).Example101000000004217
Body parameters application/json
-
walletsarray<string> OptionalLaunch wallets to list. Omit for all launch wallets. -
with_rewardsboolean OptionalInclude claimable and claimed rewards.
Returns 200 OK · application/json
Returns a list of Staking position objects under positions.
-
positionsarray<object>Staking positions.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | launch_id is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it. |
| 404 | not_found | No launch with this ID belongs to the license in your token. Check the launch ID and that your token is upgraded onto the license that owns the launch. |
| 404 | not_found | An entry of wallets is not one of the launch's wallets; a malformed address also lands here. Pass only addresses of the launch's own wallets, or omit wallets to list them all. |
| 400 | unsupported_chain | The launch is not on Solana. The body adds chain. Call it only for Solana launches (IDs starting with 101). |
| 400 | — | The body is missing, is not valid JSON, or is sent without Content-Type: application/json. The HTTP framework answers before the handler runs (before launch_id is checked) with a plain-text body, not the JSON error object. Send a JSON body with Content-Type: application/json that matches the documented fields. |
| 500 | internal_error | Printr's token API failed or does not know the launch's mint, for example because the launch is not a Printr launch. Check that the launch is a Printr launch, then retry in a few seconds. |
| 500 | internal_error | Printr's staking API failed or returned an answer the backend could not read. Retry in a few seconds. |
Also the common errors: 401 for a missing or expired session or a base token (license_required), 403 read_only_token and 429 when rate limited.
Web client proxima.launch.printrStaking.listPositions(launchId, request) src/lib/proxima/endpoints/launch/printr-staking.ts
Claim staking rewards
/launch/printr/staking/claim-rewards/{launch_id} Claims the rewards of the given positions, one transaction per wallet and position.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Refused with
403 read_only_token. - Retry
- Check before retrying Before retrying, call List staking positions with
with_rewards: true: claimable rewards back at zero mean the first claim landed. A repeat sends a new claim transaction per position and pays its fee again.
Path parameters
-
launch_idstring RequiredLaunch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (101Solana,201BSC,202Base,204Ethereum).Example101000000004217
Body parameters application/json
-
claimsarray<object> RequiredPositions to claim, at most 50.Child attributes 2
-
pubkeystring RequiredLaunch wallet that owns the position and pays the fee. -
positionstring RequiredPosition account, as a CAIP-10 identifier.
-
Returns 200 OK · application/json
-
successbooleantruewhen at least one claim landed. -
claimedintegerNumber of claims that landed. -
totalintegerNumber of claims attempted. -
resultsarray<object>One entry per claim.Child attributes 5
-
pubkeystringWallet. -
positionstringPosition claimed. -
successbooleanWhether the claim landed. -
signaturestringTransaction signature. -
errorstringWhy the claim failed.
-
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | launch_id is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it. |
| 404 | not_found | No launch with this ID belongs to the license in your token. Check the launch ID and that your token is upgraded onto the license that owns the launch. |
| 400 | bad_request | claims is empty. Send at least one claim. |
| 400 | bad_request | claims has more than 50 entries. Split the claims into batches of at most 50. |
| 400 | unsupported_chain | The launch is not on Solana. The body adds chain. Call it only for Solana launches (IDs starting with 101). |
| 400 | — | The body is missing, is not valid JSON, or claims is missing or malformed, or is sent without Content-Type: application/json. The HTTP framework answers before the handler runs (before launch_id is checked) with a plain-text body, not the JSON error object. Send a JSON body with Content-Type: application/json that matches the documented fields. |
| 500 | internal_error | The launch is still a draft: the token does not exist on chain yet. Launch the token first with Launch a token. |
| 500 | internal_error | Printr's staking API failed while the backend looked up the positions' creation transactions. Retry in a few seconds. |
| 500 | internal_error | No claim could be built: every pubkey is outside the launch, every position is unknown for its wallet, or Printr refused each one. Nothing was sent and the per-claim reasons are not returned. Take the pubkey and position pairs from List staking positions and retry. |
Also the common errors: 401 for a missing or expired session or a base token (license_required), 403 read_only_token and 429 when rate limited.
Web client proxima.launch.printrStaking.claimRewards(launchId, request) src/lib/proxima/endpoints/launch/printr-staking.ts