> For the complete documentation index, see [llms.txt](https://docs.top.market/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.top.market/trade-earn-and-upgrade/earn.md).

# Earn

Earn lets you put cards you own into the reveal pool and earn yield while they are staked. Each staked card shows an estimated APY, and the yield it has earned appears in **My Liquidity**.

Once staked, your card joins the pool that Top Market packs draw from. When another user pulls your card, one of two things happens. If they select **Sell Instantly**, the card returns to the pool and stays staked, and you earn yield from that pull. If they keep it, the pool pays you the sell price you set, in USDC, and the card becomes theirs. You set the sell price once when you stake. Until another user keeps the card, it remains yours and you can unstake it at any time.

## The Earn Page

The Earn page shows three platform-wide figures and two sections: **Staked Assets** and **My Liquidity**.

**Total TVL, Cards staked, APY range**

These figures cover every pool on Top Market: the combined value of all staked cards, the number of cards staked, and the range of estimated APY that positions are currently earning.

**Staked Assets**

Staked Assets lists every card type currently staked on Top Market, with its TVL, number of cards, and APY. You can sort the list by TVL, Cards, or APY. Select an asset to see its details.

**My Liquidity**

My Liquidity lists the cards you have staked. Each position shows its FMV, APY, Earned, and the number of days staked. From any position you can **Edit price** or **Unstake**.

![Earn page](https://content.gitbook.com/content/1y30w9E28IGrl9hCIGfM/blobs/RPDJvXzousGMVxtckcMk/images/earn-page.png)

## How Staking Works

![How staking works: stake a card, set your sell price, the card enters the draw, two outcomes when your card is pulled](https://content.gitbook.com/content/1y30w9E28IGrl9hCIGfM/blobs/qCtaPMLPmCk6LjclsDsn/images/earn-how-it-works.png)

{% stepper %}
{% step %}

#### Stake a card

The card moves from your wallet into the reveal pool contract. The physical card stays in the insured vault. Only its on-chain record changes.
{% endstep %}

{% step %}

#### Set your sell price

Your sell price is what you receive in USDC if your card is pulled and the user keeps it. Choose one of two pricing methods:

* **Use oracle price:** You are paid the oracle price at the moment the card is pulled. If the oracle price is 8 USDC when you stake and 10 USDC when the card is pulled, you receive 10 USDC. If it has dropped to 5 USDC, you receive 5 USDC.
* **Set price manually:** You are always paid the price you set. If your price is above the oracle price at the time, the card can't be pulled for now and earns nothing.

![How your sell price settles](https://content.gitbook.com/content/1y30w9E28IGrl9hCIGfM/blobs/eBZkf3TvZpraYHRimLhM/images/earn-sell-price.png)
{% endstep %}

{% step %}

#### The card enters the draw

While the card is in the pool, its position in **My Liquidity** shows an estimated APY and the yield earned so far. Every pull from the pool is decided on-chain by Chainlink VRF. No one, including Top Market, can choose which card is pulled.
{% endstep %}

{% step %}

#### Two outcomes when your card is pulled

The user who pulls your card chooses on the reveal screen whether to keep it or sell it instantly:

* **They select Sell Instantly:** The card returns to the pool and stays staked, and you earn yield from that pull. The same card can be pulled many times, and each pull earns you yield.
* **They keep the card:** The pool pays your sell price in USDC straight to your wallet, the card becomes theirs, and your position closes.
  {% endstep %}
  {% endstepper %}

## How Earn Connects to Packs and the Marketplace

Every card you stake comes from your collection, and your collection is filled in two ways:

* **From a pack:** After the reveal, **Keep the card** adds the card to your collection. If you select **Sell Instantly**, you receive the buyback price in USDC and the card does not enter your collection.
* **From the Marketplace:** Cards you buy on the Marketplace go straight to your collection and can be staked right away.

## Guide: Staking a Card to Earn Yield

### Staking a Card

{% stepper %}
{% step %}

#### Open Earn

Select Earn in the main navigation. Stake your cards lists every card you can stake.
{% endstep %}

{% step %}

#### Choose a card

Find the card you want to stake and select Stake.
{% endstep %}

{% step %}

#### Set your sell price

In the Set Sell Price window, choose Use oracle price or Set price manually. The two settle differently, as described in "Set your sell price" above.
{% endstep %}

{% step %}

#### Confirm

Select Approve & Stake. Once the pool is approved to transfer the card, staking is complete and the card appears in My Liquidity.
{% endstep %}
{% endstepper %}

![How to stake a card](https://content.gitbook.com/content/1y30w9E28IGrl9hCIGfM/blobs/T1WGmGRhdp4hbOelQLjH/images/how-to-stake.png)

### Unstaking

You can unstake a card at any time before it is pulled. In My Liquidity, find the position, select Unstake, and confirm. The card leaves the pool and returns to your wallet.

A staked card can't be listed on the Marketplace. If you want to sell it there, or you no longer want other users to be able to pull it, unstake it first.

### Viewing Your Earnings

Each time another user pulls your staked card and sells it instantly, you receive a **Buyback share**, paid straight to your wallet.

{% stepper %}
{% step %}

#### Open your Collection

Go to your Profile and open Collection.
{% endstep %}

{% step %}

#### Select History of Earnings

Find the card and select History of Earnings below it.
{% endstep %}

{% step %}

#### Review each payout

Each entry shows the Buyback share you received, when it was paid, and the wallet that opened the pack. Select View transaction to check the payment on-chain.
{% endstep %}
{% endstepper %}

![Manage your staked cards: unstake or view earnings](https://content.gitbook.com/content/1y30w9E28IGrl9hCIGfM/blobs/unrqnJ42EWCfqgZ8vFHh/images/manage-stake.png)
