Fjord Foundry Docs
Docs navigation

Welcome info

Fjord Docs

A practical guide for joining sales, launching projects, understanding claim timing, and finding the right Fjord product links.

Sale types

Choose the format that matches the launch

Each sale format supports a different launch style. Choose based on how price should be set, how buyers should enter, and when final token amounts should be known.

Known price for the full sale

Fixed Price

Use this when you already know the token price and want buyers to purchase at that same price for the whole sale.

  • Best for straightforward launches with a clear price and token amount.
  • Creators choose what token is sold, what buyers pay with, when the sale runs, and how much each wallet can buy.
  • If the sale does not meet its minimum target, buyers can refund after the sale closes.

Structured price bands

Tiered Price

Use this when you want staged pricing, such as early buyers getting access to a lower price before later tiers open.

  • Each tier has its own price, token amount, and optional timing.
  • The sale moves through one tier at a time as each tier fills or ends.
  • If a tier is almost sold out, buyers may need to enter a smaller amount.

Market-led price

Price Discovery

Use this when the market should help discover the token price during the sale instead of starting from one fixed price.

  • The live sale page shows the current price and sale progress.
  • Pricing can change during the sale, so buyers should review the current rate before each purchase.
  • Claiming and sale timing may differ from fixed price, tiered price, and batch price sales.

Final amount after close

Batch Price

Use this when you want all accepted buyers to receive the same final price after the sale ends.

  • Buyers enter how much they want to contribute during the sale.
  • Final token amounts are shown after the sale closes.
  • If demand is higher than the sale size, part of a buyer's contribution may be refunded.
FormatWhen you know your amountOversubscriptionBest for
Fixed PriceImmediately, at the set priceOptionalA single known price for the whole sale
Tiered PriceImmediately, at the current tier's priceNot usedStaged pricing with cheaper early tiers
Price DiscoveryImmediately, at the live price when you buyMarket-ledA market-led price that moves with demand
Batch PriceAfter the sale closesOptionalOne shared final price for everyone

Sale lifecycle

How a sale moves from open to claim

Every sale moves through the same set of phases. Knowing them explains why claiming is not always instant and what each status on the sale page means.

  1. 1

    Pending

    Before start

    The sale is created but not open yet. The creator can still cancel it during this window. Once the sale starts, it can no longer be cancelled.

  2. 2

    Presale

    Optional, first

    A gated phase that requires FJoints to take part. Not every sale has one, and it is configured by Fjord rather than the project. See Presale & FJoints.

  3. 3

    Whitelist

    Optional

    Only approved wallets can buy, sometimes with per-wallet limits or tier access. It has its own cap and end time. See Whitelist & access.

  4. 4

    Public

    Open phase

    Open to anyone within the sale's wallet limits, until the sale's end time or until it sells out.

  5. 5

    Ending

    After end or sold out

    When the end time passes or the sale sells out, it waits to be finalised. Finalising is not automatic — anyone can trigger it, but until someone does, nothing can be claimed or refunded.

  6. 6

    Closed or Failed

    Final state

    If the sale met its minimum target, it closes as successful. If it did not, it fails and buyers can be refunded (minus any buy fees already paid).

  7. 7

    Claim window

    After close

    Claiming opens at the sale's redemption time, which can be later than the moment the sale closed. Claim or refund using the same wallet you bought with.

Fixed Price

Fixed Price in detail

One price per token for the entire sale. The simplest format when you already know the price.

One price throughout

Every buyer pays the same set price per token for the whole sale. No bidding and no bands.

What leaves your wallet

You pay the price times the amount you buy, plus a buy fee added on top, so the total leaving your wallet is a little more than the headline cost. See Fees.

Wallet limits

Each wallet has a minimum first purchase and a maximum total it can buy across the whole sale.

Selling out early

Once all tokens are allocated, the sale is sold out and can be finalised before its end time.

Can be oversubscribed

A fixed-price sale can optionally cap demand. If buyers contribute more than the cap, a lottery or pro-rata split decides allocations. See Oversubscription.

If it under-raises

If the sale does not reach its minimum target, it fails and buyers can be refunded, minus any buy fees already paid.

Tiered Price

Tiered Price in detail

Several price bands filled in order, usually cheapest first. Good for rewarding early buyers.

Bands filled in order

The sale starts in the first tier and moves to the next as each one fills or ends.

A tier ends two ways

A tier closes when it sells out or when its optional end time passes, whichever comes first. A cheap early tier can close on time before you get in.

One purchase, one tier

A single purchase cannot span two tiers. If the current tier has fewer tokens left than you asked for, lower your amount; the rest may be available in the next tier as a separate purchase.

Per-tier limits

Each tier can set its own minimum and maximum per wallet.

No oversubscription

Tiered sales do not use lottery or pro-rata. Once the last tier is gone, the sale is sold out and further buys are rejected.

Price Discovery

Price Discovery (LBP) in detail

A market-led sale, also called a Liquidity Bootstrapping Pool. The price usually starts high and drifts down over time, and buying pushes it back up, so the market settles on a price.

Live, moving price

Instead of one fixed price, the sale shows a live price that changes as time passes and as people buy. You buy at the price shown when your purchase goes through.

Starts high on purpose

The opening price is set deliberately high to discourage bots and snipers. It is meant to come down, so the very start is usually the worst time to buy.

Why the price falls

Over its run, the sale gradually shifts the balance between the project token and the payment token. That shift pushes the price down on its own — even with no buyers — until demand meets it.

Demand pushes back up

Buying raises the price, so strong early demand can hold it up while quiet demand lets it keep falling. Buy when the live price looks fair to you.

Buy Only or Buy & Sell

Some of these sales let you sell back during the event; others are buy-only. The sale page shows which mode is in use.

Limits and access

There is usually no per-wallet cap, though a creator can set an overall hard cap or gate access with a whitelist. Check the sale page.

Fees and slippage

A swap fee and platform fee can apply and are shown on the sale page. You can also set a slippage tolerance on each purchase. See Fees.

Claiming after the event

You cannot claim during the sale. Tokens become claimable after it ends, sometimes after a short delay or on a vesting schedule. See Vesting & claims.

Price Discovery for creators

Creating a Price Discovery sale

A Price Discovery (LBP) launch is the most configurable sale type. This is the full reference for the choices you make and what they do.

Start with zero funds up front

Price Discovery sales use virtual liquidity: the payment-side reserve that shapes the price curve is synthetic, so you never lock real payment tokens to launch. You only place your project tokens in the pool. Starting a sale with no capital up front is a core advantage of this format.

Weights set the price curve

The start and end weights are the balance between your token and the payment token. A high start weight and low end weight create a steeper price fall and distribute more of your tokens. The default is 90/10 to 10/90.

Pick weights for your distribution goal

Fjord's recommended recipe is 99/1 to 1/99, which aims for close to full token distribution. Less extreme end weights, such as 70/30 or 60/40, distribute fewer tokens and keep more of a price floor.

Set the starting price high

Set the opening price well above your expected fair value. A high open deters bots and is meant to fall until real demand meets it. Too low an open invites snipers at the start.

Buy Only or Buy & Sell

Buy & Sell lets participants sell back during the event for fuller price discovery, but the price can swing down as a result. Buy Only restricts the event to purchases. The mode is shown publicly on the sale page.

Caps, access, and limits

There are no per-wallet limits on a Price Discovery sale. You can set an optional hard cap on the total payment token raised, and gate access with a whitelist for a private or partner launch.

Vesting and claim timing

Buyers cannot claim during the event. Release tokens immediately at the end, add a redemption delay (useful if you want to set up trading first), or vest over time with an optional cliff. Vesting starts at the sale's end.

Fees and payout

A swap fee and platform fee apply and are shown on the sale page. The payment token you raise is sent to your wallet, minus the platform fee.

Settings reference

SettingWhat it controlsRecommendation
Project tokens in poolHow many of your tokens are offered for sale.Placed in the pool when you create the sale. Decide this against your circulating versus total supply.
Payment tokenWhat buyers pay with.Pick a liquid token your audience holds, such as a major stablecoin or a wrapped native token.
Collateral reserveThe virtual payment-side reserve that shapes the price curve.Always virtual — no real funds are locked. It only sets the curve, so you launch with zero capital up front.
Start / end weightsHow steeply the price falls and how much distributes.Default 90/10 to 10/90. Use 99/1 to 1/99 for near-full distribution; gentler end weights distribute less.
Starting priceThe opening price per token.Set well above expected fair value so the curve can fall into real demand.
Sale windowWhen the sale runs.Minimum 1 day, maximum 10 days. A few days (commonly 2 to 5) gives demand time to discover a price.
Sale modeBuy Only or Buy & Sell.Buy Only for a cleaner upward-only demand signal; Buy & Sell for fuller two-way discovery.
Hard capAn optional limit on total raised.Leave off for open discovery, or set a cap to stop raising once you hit a target.
WhitelistRestricts who can buy.Optional. Add an allow-list for a private or partner-gated launch.
Vesting & redemption delayWhen and how buyers receive tokens.Immediate, after a delay, or vested with an optional cliff. Vesting starts at the sale's end.

The create flow, step by step

  1. 1

    Add your token

    Enter your token's contract address and upload a token image (and an optional banner). If your token has transfer restrictions or hooks, test on a testnet first.

  2. 2

    Choose the mode

    Pick Buy Only or Buy & Sell.

  3. 3

    Set quantities, weights, and timing

    Choose how many tokens to offer, the payment token, the start and end weights, the starting price, and the sale window. The create flow previews the price curve as you go.

  4. 4

    Add vesting (optional)

    Release tokens immediately at the end, add a redemption delay, or vest over time with an optional cliff.

  5. 5

    Fill in project details

    Add a description, links, category, any geo-blocking, and social links so buyers can evaluate the launch.

  6. 6

    Review and sign

    Check the summary, approve your token spend, and sign the creation transaction. The sale is then indexed and goes live at its start time.

Batch Price

Batch Price in detail

Everyone contributes during the sale and shares one final price worked out at the close.

Final amount known at close

No one's token amount is fixed while the sale is live. Allocations are worked out when the sale closes.

One shared price

The final price is the total contributed divided by the tokens for sale. Your tokens are your share of the total contributions, so everyone pays the same average price.

Contribution limits

Each wallet has a minimum and maximum amount it can contribute.

Hard cap

A sale can set a cap on total contributions. Reaching it sells the sale out early.

If demand is capped

If the sale caps accepted demand, contributions above the cap are refunded — split pro-rata (overflow) or chosen by lottery. See Oversubscription.

Oversubscription

When demand is more than the sale can accept

Some sales accept only up to a set amount. If buyers contribute more than that cap, one of two methods decides who gets what.

Overflow (pro-rata)

Everyone's accepted amount is scaled down by the same proportion so the total matches the cap. You always get a slice, and the unaccepted part of your contribution is refunded.

Lottery (random)

Wallets are selected at random until the cap is filled. A wallet can be fully accepted, partly accepted, or not accepted at all. Anything not accepted is refunded.

Results come after close

With either method you only learn your final accepted amount after the sale closes and the result is worked out. Refunds of unaccepted contributions arrive when you claim.

Tiered sales are different

Tiered sales never oversubscribe — they simply sell out. Oversubscription applies to fixed-price and batch sales when the creator enables it.

Presale & FJoints

FJoints-gated presales

Some sales open with a presale that is gated by FJoints — the token you earn by staking $FJO.

What a presale is

An early phase that only buyers spending FJoints can join, before any whitelist or public phase opens.

FJoints are spent, not staked

To buy in a presale you spend FJoints alongside your payment token, at a set ratio per unit contributed.

FJoints are burned for good

FJoints used in a presale are burned and never returned — even if the sale fails or your payment token is refunded. Treat them as spent.

Its own cap and timing

The presale has its own contribution cap and end time. When it ends, the sale moves on to its whitelist or public phase.

Set up by Fjord

Presale terms are configured by the Fjord protocol, not the project creator.

Whitelist & access

Who can buy, and when

A whitelist phase can run before the public phase to limit who can take part. Access can work three ways.

Approved wallets

Only wallets on an allow-list can buy. If you are not on it, you cannot take part in this phase.

Per-wallet amount caps

Each approved wallet has its own maximum it can contribute, on top of the sale's overall limits.

Tier access

In tiered sales, the list can control which price band a wallet is allowed to buy from.

Proving access

Eligibility is usually proven from a list the creator publishes. The sale page will tell you whether your wallet qualifies.

Its own cap and end

The whitelist phase can have its own total cap and end time, separate from the rest of the sale.

Vesting & claims

Gradual token release

Some sales release your tokens over time instead of all at once.

Delivered as a stream

A gradual release is delivered as a transferable stream held in your wallet. You can move it to another wallet if you choose.

Cannot be cancelled

Once a release stream starts, no one can cancel it — the creator cannot claw back your vesting tokens.

Start unlock

A schedule can release a portion immediately when vesting begins.

Cliff

A cliff is a date before which a chunk stays locked, then unlocks all at once when the date arrives.

Linear release

Whatever is not unlocked at the start or cliff is released steadily until the schedule's end date.

Fees

What you pay and when

A few different fees can apply to a sale. Some matter to buyers up front; others apply to creators at the close.

Buy fee (buyers)

Added to every purchase in the payment token. The total leaving your wallet is your contribution plus this fee.

Platform fee (creators)

Taken from the final raised amount on a successful sale.

Penalty fee

Can apply if a sale fails or if tokens go unsold.

Refunds are not whole

If a sale fails you can be refunded your contribution, but buy fees you already paid are not returned. No platform fee is taken from a failed raise.

Referrals

Earning and claiming referral rewards

Some sales reward you for bringing in buyers. When enabled, the rules below apply.

Earn the right to refer

You usually need to have contributed at least a minimum amount before you can generate your referral link.

Buyers bind to one referrer

When a buyer uses a code on their first purchase they are tied to that referrer for the whole sale. They cannot switch later, and you cannot refer yourself.

Rewards finalise at close

Referral rewards are worked out after the sale closes. Under oversubscription they scale with the amount actually accepted.

Claimed separately

Rewards are not paid automatically when you claim tokens. Use the claim-rewards action to collect them.

Liquidity after sale

Trading once the sale ends

A creator can set up a trading pool automatically when the sale closes.

Auto-seeded pool

At the close, the sale can use part of the raised funds and tokens to seed a trading pool, so the token is tradable soon after.

Locked liquidity

The resulting position can be locked for a set period before the creator can withdraw it.

For buyers

Whether and where you can trade after a sale depends on the creator's setup. Check the sale page for trading links.

Anti-snipe

Why some sales only work in the app

To keep bots from sniping a launch, some sales require every purchase to be approved through the official Fjord app.

Buy through the app

For these sales you cannot buy directly from the contract or a block explorer — use the sale page in the Fjord app.

Why it exists

The approval step blocks automated scripts from front-running real buyers at the start of a sale.

$FJO

$FJO, staking, and tokenomics

Use these links to find the current $FJO purchase path, staking information, tokenomics stats, and buyback or burn figures.

Token access

Buy $FJO

Use the live app links when buying $FJO so you see the current network and available purchase options.

Rewards

Stake $FJO

Staking $FJO can earn $FJO and FJoints rewards. Current staking positions are locked for six weeks before withdrawal.

Live figures

$FJO tokenomics

Use live staking stats for current supply, staked $FJO, rebought $FJO, and burned $FJO.

Supply updates

Buyback and burn

The staking page reports total $FJO rebought and burned. These numbers can change over time, so use the live page for current figures.

For sale participants

Participating in a token sale

Use the sale page as the source of truth. Every sale can configure different access rules, caps, supported chains, and claim timing.

  1. 1

    Review the sale

    Check the sale type, what buyers pay with, network, start and end time, funding goal, wallet limits, who can join, and when tokens can be claimed.

  2. 2

    Connect and approve

    Connect the wallet you want to use. If your wallet asks for permission to spend the payment token, approve it before buying.

  3. 3

    Buy or swap

    Enter the amount you want to contribute. The sale page will show what you are buying and whether the final amount is known now or after the sale closes.

  4. 4

    Track the close

    After the sale ends, watch the sale page for the final status. It will show whether claiming, gradual token release, or refunding is available.

  5. 5

    Redeem

    When the claim or refund button is available, use the same wallet you participated with to receive tokens, start a gradual token release, or claim a refund.

For sale creators

Creating a sale

Before creating a sale, turn the launch plan into clear choices buyers can understand.

  1. 1

    Choose the sale type that matches the launch goal: fixed price for a simple known price, tiered price for staged pricing, batch price for one final price, or price discovery for a market-led launch.

  2. 2

    Gather the basics: what token you are selling, what buyers pay with, which network you are using, sale dates, tokens for sale, funding goal, and wallet limits.

  3. 3

    Decide who can join: everyone, invited wallets only, partner communities, referral links, or a mix of those options.

  4. 4

    Decide when buyers receive tokens: right after the sale, on a specific claim date, or gradually over time.

  5. 5

    Prepare the public sale page with project details, token information, links, visuals, launch partner context, and clear claim expectations.

  6. 6

    Review every setup choice before publishing. Key sale settings may not be editable once the sale is live.

Sale setup

Before you create a sale

Use this checklist to prepare the decisions you need before opening the Create a Sale flow.

Pick the sale format

Choose fixed price, tiered price, batch price, or price discovery based on how you want buyers to enter.

Set the sale window

Choose when the sale opens, when it ends, and whether claiming should start immediately or later.

Define buyer limits

Set minimum and maximum contribution amounts so buyers know how much they can participate.

Choose access rules

Decide whether anyone can join or whether only invited wallets, partner communities, or referral links should work.

Plan token delivery

Decide whether buyers claim all tokens at once or receive them gradually over time.

Prepare the project page

Add clear project information, token details, links, visuals, and claim instructions before publishing.

DecisionAreaWhat to choose
Sale goalPricingUse a fixed price for certainty, tiers for staged pricing, batch for one final price, or price discovery when you want the market to guide price.
Buyer accessWho can joinChoose public access for the broadest reach, or limit the sale to invited wallets when needed.
Contribution limitsBuyer limitsMinimum and maximum wallet amounts help buyers understand the rules and can keep the sale from being dominated by a few wallets.
Token releaseClaimsUse a gradual release when buyers should receive tokens over time. Make the schedule clear before the sale starts.
Trading after the saleAfter saleDecide whether there should be a planned liquidity step after the sale and explain where buyers should look for trading information.
ReferralsGrowthIf referrals are part of the launch, explain who can earn rewards, how links are shared, and when rewards can be claimed.

Platform resources

Stats, referrals, and launch partners

Use these links for platform stats, project referrals, and sale referral rewards.

Platform context

Fjord Stats

Use live app stats for active sales, completed sales, staking totals, rebought $FJO, and burned $FJO.

Launch partner motion

Invite a Project

Projects preparing a launch can compare sale types and gather launch details before talking through partner support.

Growth rewards

Earn via Referrals

Some sales may support referral rewards. If enabled, the sale page will show how referrals work and when rewards become available.

After close

Claims and refunds

A sale ending does not always mean claiming starts immediately. The sale page will show the next available action.

Successful sale

The sale page will show when buyers can claim tokens and whether tokens are released gradually.

Failed sale

If the sale does not meet its minimum target, buyers can refund once the action appears — your contribution back, minus any buy fees already paid.

Delayed claims

Some projects set a future claim date or gradual token release. Check the sale page for the exact timing.

Claim deadline

If a sale has a claim deadline, claim before it passes. After it, unclaimed tokens can be permanently recovered by the protocol.

Glossary

Plain-language terms

The friendly words used across these docs and the sale pages, in one place.

TermWhat it means
Payment tokenWhat you pay with — the token you contribute to a sale.
Tokens for saleThe project's token you are buying.
Minimum targetThe smallest amount a sale must raise to succeed. Below it, the sale fails and buyers can be refunded.
Wallet limitsThe minimum and maximum a single wallet can buy or contribute.
Sold out / hard capThe point where a sale has accepted all it can and stops taking contributions.
OversubscriptionWhen buyers contribute more than the sale will accept, handled by overflow or lottery.
OverflowA pro-rata cut so everyone gets a proportional share and the rest is refunded.
LotteryA random selection of wallets until the cap fills; unselected wallets are refunded.
Price Discovery / LBPA market-led sale (Liquidity Bootstrapping Pool) where the live price starts high and falls over time until demand meets it.
WeightsThe shifting balance between the token and the payment token in a Price Discovery sale that pushes the price down over time.
Virtual liquidityA synthetic payment-token reserve that shapes a Price Discovery sale's price curve without the creator locking real funds up front.
WhitelistA phase where only approved wallets can buy.
PresaleAn early, FJoints-gated phase before whitelist or public.
FJointsA token earned by staking $FJO, spent and burned to join a presale.
VestingA gradual release of tokens over time instead of all at once.
CliffA date before which part of a vesting schedule stays locked, then unlocks at once.
CloseFinalising a sale after it ends so claims or refunds can begin.
Redemption / claimCollecting your tokens, refund, or vesting stream after the close.
ClawbackA final deadline after which unclaimed tokens can be recovered by the protocol.
Buy feeA fee added to each purchase in the payment token.
Liquidity seedingAutomatically creating a trading pool when the sale closes.

FAQ

Common questions

Short answers for the cases users most often need before buying or creating a sale.

Can I make multiple purchases in one sale?

Yes, if the sale is still open, your wallet is allowed to join, and your total purchase stays within the sale limits.

What sale type should I choose?

Use fixed price for a simple known price, tiered price for staged pricing, batch price when buyers should share one final price, and price discovery when you want the market to help set price.

What is the difference between a lottery and an overflow sale?

Both handle more demand than a sale will accept. Overflow scales everyone down proportionally, so every accepted buyer gets some tokens. A lottery picks wallets at random, so you might be fully accepted, partly accepted, or not accepted at all and refunded instead.

Should I buy as soon as a Price Discovery (LBP) sale opens?

Usually not. The starting price is set deliberately high to deter bots and is designed to fall over time. Buying at the open often means overpaying. Watch the live price and buy when it looks fair to you.

Why is a Price Discovery price falling when no one is buying?

These sales gradually shift the balance between the project token and the payment token over their run, which pushes the price down on its own. Buying counteracts it, so quiet demand lets the price keep drifting down.

Can I sell my tokens back during a Price Discovery sale?

Only if it is a Buy & Sell sale. Buy-only sales do not allow selling during the event. The sale page shows which mode is in use.

As a creator, do I need to provide collateral up front for a Price Discovery sale?

No. Price Discovery sales always use virtual liquidity — a synthetic reserve that shapes the price curve — so you never lock real payment tokens. You only place your project tokens in the pool. Launching with zero capital up front is a core advantage of this format.

What start and end weights should I choose for a Price Discovery sale?

The default is 90/10 to 10/90. For close to full token distribution, Fjord recommends 99/1 to 1/99. Gentler end weights such as 70/30 distribute fewer tokens and keep more of a price floor.

Can I change the weights or price after my Price Discovery sale starts?

No. Weights, the price curve, and timing lock when the sale starts. You can pause and resume swaps, hide the sale, cancel before it starts, and withdraw the raised funds after it ends.

How long should a Price Discovery sale run?

Between 1 and 10 days. A few days, commonly 2 to 5, gives demand time to find a fair price.

Why did my tiered purchase fail?

The current tier may not have enough tokens left for the amount you entered. Try a smaller amount or wait for the next tier if the sale has one.

Why is claiming unavailable right after a sale ends?

A sale must be finalised before claims or refunds open, and the claim time can be later than the close. The sale page will update when the next action is available.

What happens if more people buy than the sale can accept?

Depending on the sale setup, only part of your contribution may be accepted and the rest may become refundable after the sale closes.

Do I get my FJoints back after a presale?

No. FJoints spent in a presale are burned and are never returned, even if the sale fails or your payment token is refunded.

What is a cliff in a vesting schedule?

A cliff is a date before which part of your tokens stay locked. When the cliff date arrives, that portion unlocks at once, and the rest continues releasing over time.

Why can I only buy some sales in the Fjord app?

Sales with anti-snipe protection require each purchase to be approved through the official app, which blocks bots. Use the sale page in the app rather than buying directly from the contract.

Are presale perks or referral rewards guaranteed?

No. Review each sale page carefully. Access rules, referral rewards, and reward timing can differ by sale.

Can I edit a sale after publishing?

Some project page details may be editable, but important sale choices can be locked once published. Review everything before going live.