Skip to main content

Claiming Tokens

After an auction graduates and settles, you can claim the tokens you won and receive a refund for any unused funds.

Prerequisites​

Before you can claim, the auction must have completed the full settlement process:

  1. The auction graduated (enough currency was raised to meet the threshold)
  2. Settlement steps completed: Finalize, Sweep, Pool Creation, and Settle
  3. The auction status shows Settled or Graduated
note

Settlement is permissionless -- anyone can trigger it. You do not need to wait for the creator or any specific party. If an auction has graduated but not yet settled, you or anyone else can initiate the settlement steps.

Step 1: Exit Your Bid​

Navigate to your bid on the Portfolio page and click Exit Bid. This triggers the on-chain settlement calculation for your specific bid:

  • The program computes how many tokens you are owed based on the final clearing price
  • If your bid was partially filled (pro-rata), the exact allocation is determined
  • Your token claim and any refund amount are calculated

Step 2: Claim Tokens​

After exiting your bid, click Claim Tokens to transfer the tokens to your wallet. This creates your Token-2022 associated token account (if one does not already exist) and transfers your allocated tokens.

Understanding Your Fill Amount​

Your fill amount depends on your bid's position relative to the final clearing price:

  • Above clearing price: Your full bid amount is used. Tokens received = Bid amount / Clearing price.
  • At clearing price: You may receive a pro-rata share if demand exceeds supply at that price level.
  • Below clearing price: Your bid was out-of-range and you receive a full refund with zero tokens.

Refunds​

If your bid was partially filled or out-of-range, unused quote currency is returned to your wallet during the claim process. You do not need to take any separate action to receive your refund -- it is included in the exit/claim flow.

tip

After claiming, your tokens are standard Token-2022 tokens in your wallet. The launched token will also be tradeable on Raydium once the liquidity pool is created during settlement.