> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sqd.dev/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Reach for SQD when you need onchain data without running a node or an indexer: decoded EVM logs and transactions, Solana instructions, Bitcoin transactions, Substrate events and calls, or Hyperliquid fills, over any block range on 110+ networks.
> To query directly, POST to https://portal.sqd.dev/datasets/{dataset}/stream. The full API is described at https://docs.sqd.dev/openapi.json, and responses to the stream endpoints are JSON Lines.
> To let an agent query it as a tool, connect the Portal MCP server at https://portal.sqd.dev/mcp.
> For Portal availability errors, stalled streams, or rate limiting, read https://status.sqd.dev/status.md. The status index at https://status.sqd.dev/llms.txt explains network and plan filters.
> Every page on this site is available as Markdown by appending .md to its URL.

# Provide SQD to a Portal Pool

> Deposit SQD into a Portal Pool, claim rewards, and withdraw in the Network App.

A Portal Pool lets you supply SQD to a Portal operator without running a
Portal yourself. The pool stakes your SQD to give the operator's Portal query
capacity, and the operator pays the pool's providers rewards in a stablecoin,
such as USDC or USD₮0. In return for your deposit you get `plSQD`, a receipt
token, one for each SQD.

Everything a provider does happens on the pool pages of the
[Network App](https://network.sqd.dev). This guide walks through choosing a
pool, providing SQD, claiming rewards, and withdrawing. For how operators fund
the rewards, see [Operate a Portal Pool](https://docs.sqd.dev/en/network/portal-pool-operators.md).

To provide, you need a wallet on Arbitrum One holding SQD (see
[Get SQD](https://docs.sqd.dev/en/network/procuring-sqd.md)) and a little ETH on Arbitrum One for gas.
SQD held in a vesting contract cannot be provided to a pool.

## Find a pool

Open the **Dashboard** and switch to the **Portal Pools** tab, or go straight
to [network.sqd.dev/dashboard/portal-pools](https://network.sqd.dev/dashboard/portal-pools).
The table lists each pool's **Status**, **APY**, **TVL**, **Capacity**, and
**Total Funding**. Click a pool to open its page.

The pool page shows:

* **The header**: the pool's name, a status label, a **Whitelist** badge if
  only approved addresses can join, and a bar showing how full the pool is.
  While the pool is collecting, the bar also counts down to the end of the
  provision window.
* **TVL**, **APY**, and **Total Funding** (rewards the operator has funded so
  far), followed by a yield chart and the pool's activity.
* On the right, your **Current Balance** and **Available Rewards** cards, and
  **Pool Info** with the pool contract, the operator, the `plSQD` token
  (**LP-Token**), and the reward token.

## Before you provide

### Pool status

The status label tells you whether the pool pays rewards right now:

| Status | What it means for you |
| - | - |
| **Collecting** | The pool is filling up. Your SQD stays in the pool and earns nothing yet, and you cannot withdraw until the pool activates or fails. |
| **Active** | The pool is full enough to run and is paying rewards. |
| **In Debt** | The operator's reward funding has run out. Nothing is earned until the operator tops up, and the missed time is not paid later. |
| **Paused** | The pool's total deposits fell below 1,000,000 SQD. Rewards stop until deposits recover. |
| **Failed** | The pool did not fill before its provision window closed. Withdraw your SQD; it is returned in full at once. |
| **Closed** | SQD shut the pool down. Withdraw at once and claim what you earned. |

A pool activates when deposits reach its capacity. Its provision window is
30 days from creation; if it does not fill by then, it fails.

### APY and rewards

The operator sets a reward rate for the whole pool at full capacity. Every SQD
in the pool earns the same share of it, however full the pool is, so your
rewards are:

```
your rewards per day = pool's daily rate × your SQD ÷ pool capacity
```

The **APY** in the app follows the same logic: monthly payout × 12, divided by
the pool's capacity valued at the live SQD price. Because it is a ratio of a
stablecoin payout to the SQD price, it moves with the SQD price. The operator
can also change the rate or the capacity at any time.

Rewards depend on the operator keeping the pool funded. Returns are not
guaranteed.

### Withdrawals take time

Leaving an active pool goes through an exit queue that releases 1 SQD per
second (about 86,400 SQD a day) for the whole pool. Your wait depends on how
much other providers have queued ahead of you. The withdraw dialog shows the
expected unlock date before you confirm.

## Provide SQD

**1. Connect your wallet**

Connect your wallet in the Network App and open the pool's page.

**2. Open the provide dialog**

Click **PROVIDE** in the **Current Balance** card. The first time, the app
shows the **Terms of Use**; read them and click **ACCEPT**.

If the button is greyed out, hover over it for the reason: the pool is full,
you have reached the per-wallet limit, you are not on the pool's whitelist, or
the pool no longer accepts deposits.

**3. Enter the amount**

Enter the amount of SQD, or click **Max** for the most you can provide. The
dialog previews the pool's **Total Tokens**, **Your Tokens**, and your
**Expected Monthly Payout**.

One wallet can hold at most 250,000 SQD in a pool, and the pool accepts no
more than its remaining capacity.

**4. Confirm in your wallet**

Confirm the dialog. Your wallet asks you to approve the SQD spend, unless you
already have, and then to sign the deposit.

> [!TIP]
>
> Your **Current Balance** shows the new amount, and the same amount of
> `plSQD` arrives in your wallet.

If you provide while the pool is collecting, your SQD stays locked until the
pool activates or its provision window closes. If it fails to activate, you
withdraw in full.

## Claim rewards

The **Available Rewards** card shows what you have earned, in the pool's
reward token, and an estimate per day at your current balance. Click **CLAIM**
to send it to your wallet.

Rewards accrue every second while the pool is **Active**. They do not accrue
while it is collecting, paused, or in debt, or on SQD you have asked to
withdraw. What you have earned stays claimable: withdrawing your SQD does not
claim or forfeit rewards, so claim them separately.

## Withdraw

### From an active pool

**1. Request the withdrawal**

Click **WITHDRAW** in the **Current Balance** card. Enter the amount, or click
**Max**. The dialog shows the **Expected Unlock Date**.

Confirm in your wallet. The amount stops earning rewards at once, and the same
amount of `plSQD` is burned from your wallet.

**2. Wait for the unlock**

The request appears in a table under **Available Rewards**, with its **Exit
ID**, **Amount**, and **Time Left**. Each request counts down separately.

**3. Release the SQD**

When **Time Left** shows **Ready**, click **RELEASE**. The SQD returns to your
wallet.

You can withdraw the same way while the pool is paused or in debt. While it is
collecting, withdrawals are not possible.

### From a failed or closed pool

No queue applies. The button changes to **WITHDRAW ALL** in a failed pool and
**EMERGENCY WITHDRAW** in a closed one, and returns your whole balance at once,
including anything already waiting in the queue. In a closed pool, claim your
earned rewards with **CLAIM** as usual.

## The plSQD token

`plSQD` is a standard token that represents your deposit, one for each SQD.
Each pool has its own; the **Add to Wallet** button next to **LP-Token** in
**Pool Info** adds it to your wallet.

Sending `plSQD` to another address moves the matching part of your deposit to
them. The rewards you earned before the transfer stay yours, and the recipient
starts earning from the moment of the transfer. A transfer fails if it would
take the recipient over the 250,000 SQD per-wallet limit, if it includes SQD
you have asked to withdraw, or, in a whitelisted pool, if the recipient is not
on the whitelist.

## Related

> [card] [Operate a Portal Pool](https://docs.sqd.dev/en/network/portal-pool-operators.md)
>
> How operators fund rewards and what the pool's limits are.

> [card] [Contract addresses](https://docs.sqd.dev/en/other/contracts.md#portal-pool-system-arbitrum-one)
>
> Factory, registry, and live pool addresses.


## Related topics

- [Operate a Portal Pool](https://docs.sqd.dev/en/network/portal-pool-operators.md)
- [SQD Network](https://docs.sqd.dev/en/network/overview.md)
- [Ways to participate](https://docs.sqd.dev/en/network/participate.md)
- [Network, Portal and SDK FAQ](https://docs.sqd.dev/en/other/faq.md)
- [SQD plugin for Cursor](https://docs.sqd.dev/en/ai/plugins-cursor.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.