Skip to content
API Reference

Search is only available in production builds. Try building and previewing the site to test it out locally.

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.

A Printr staking position held by a launch wallet, with its rewards when requested.

Attributes

  • info object
    The position.
    Child attributes 12
    • owner string
      Wallet that owns the position.
    • position string
      Position account, as a CAIP-10 identifier.
    • lock_period enum
      Lock period of the position.
      Possible values STAKING_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
    • staked object
      Amount staked.
      Child attributes 5
      • asset object
        Asset reference.
        Child attributes 1
        • account string
          Asset account.
      • decimals integer
        Token decimals.
      • atomic string
        Amount in atomic units.
      • display string
        Amount formatted for display.
    • created_at string
      Creation time, ISO 8601.
    • unlocks_at string
      Unlock time, ISO 8601.
    • was_closed boolean
      Whether the position has been closed.
  • claimable_quote_rewards object | null
    Quote rewards claimable now.
    Child attributes 5
    • asset object
      Asset reference.
      Child attributes 1
      • account string
        Asset account.
    • decimals integer
      Token decimals.
    • atomic string
      Amount in atomic units.
    • display string
      Amount formatted for display.
  • claimable_telecoin_rewards object | null
    Token rewards claimable now.
    Child attributes 5
    • asset object
      Asset reference.
      Child attributes 1
      • account string
        Asset account.
    • decimals integer
      Token decimals.
    • atomic string
      Amount in atomic units.
    • display string
      Amount formatted for display.
  • claimed_quote_rewards object | null
    Quote rewards already claimed.
    Child attributes 5
    • asset object
      Asset reference.
      Child attributes 1
      • account string
        Asset account.
    • decimals integer
      Token decimals.
    • atomic string
      Amount in atomic units.
    • display string
      Amount formatted for display.
  • claimed_telecoin_rewards object | null
    Token rewards already claimed.
    Child attributes 5
    • asset object
      Asset reference.
      Child attributes 1
      • account string
        Asset account.
    • decimals integer
      Token decimals.
    • atomic string
      Amount in atomic units.
    • display string
      Amount formatted for display.
POST /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_id string Required
    Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (101 Solana, 201 BSC, 202 Base, 204 Ethereum).
    Example101000000004217

Body parameters application/json

  • lock_period enum Required
    How long the tokens stay locked.
    Possible values STAKING_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
  • amount integer Required
    Tokens to stake per wallet, atomic units. Must be greater than 0.
  • wallets array<string> Optional
    Launch wallets to stake from. Omit for all launch wallets.

Returns 200 OK · application/json

  • success boolean
    true when at least one position was created.
  • created integer
    Number of wallets whose position was created.
  • total integer
    Number of wallets attempted.
  • results array<object>
    One entry per wallet.
    Child attributes 4
    • pubkey string
      Wallet.
    • success boolean
      Whether this wallet staked.
    • signature string
      Transaction signature.
    • error string
      Why this wallet failed.

Errors

StatusCodeWhen 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

POST /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: POST only 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_id string Required
    Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (101 Solana, 201 BSC, 202 Base, 204 Ethereum).
    Example101000000004217

Body parameters application/json

  • wallets array<string> Optional
    Launch wallets to list. Omit for all launch wallets.
  • with_rewards boolean Optional
    Include claimable and claimed rewards.

Returns 200 OK · application/json

Returns a list of Staking position objects under positions.

  • positions array<object>
    Staking positions.

Errors

StatusCodeWhen 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

POST /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_id string Required
    Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (101 Solana, 201 BSC, 202 Base, 204 Ethereum).
    Example101000000004217

Body parameters application/json

  • claims array<object> Required
    Positions to claim, at most 50.
    Child attributes 2
    • pubkey string Required
      Launch wallet that owns the position and pays the fee.
    • position string Required
      Position account, as a CAIP-10 identifier.

Returns 200 OK · application/json

  • success boolean
    true when at least one claim landed.
  • claimed integer
    Number of claims that landed.
  • total integer
    Number of claims attempted.
  • results array<object>
    One entry per claim.
    Child attributes 5
    • pubkey string
      Wallet.
    • position string
      Position claimed.
    • success boolean
      Whether the claim landed.
    • signature string
      Transaction signature.
    • error string
      Why the claim failed.

Errors

StatusCodeWhen 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