# Seasons Terminal: the full guide for agents

> Seasons is a Solana protocol whose token, $SEAS, pays its holders. Every $SEAS buy, sell and transfer pays a 10% tax; that income is paid out to "nodes": wallets holding 1,000+ $SEAS (Builders, paid weekly in $SEAS) or 10,000+ $SEAS (Directors, paid every Sunday and Wednesday in a basket of gold, bitcoin and dollars). The Seasons Terminal is the protocol's dashboard: network-wide figures for anyone, and a node's own payouts, tier and claims for a person signed in.

Site: https://fidelius.network. Short version: https://fidelius.network/llms.txt.

## Rules for agents

- Everything a visitor can see is public: read it from the JSON API below rather than the pages, whose figures load by script after the HTML.
- A person's own figures (their balance, payouts, tier, claims) need their own sign-in. The API has no per-wallet data by design: never ask for a wallet address in order to look it up here.
- You cannot sign in, sign a message or pay for anyone. Guide them through the steps in "How to do things on the terminal", quoting the labels they will see.
- Never ask for, or accept, a seed phrase or private key. Seasons never asks for one, and nothing on the terminal needs one.
- Payouts depend on trading volume and can fall as well as rise. Quote figures as of the snapshot time, and do not promise returns.

## Live snapshot (Thursday, November 5, 2026 at 12:46 PM UTC)

- $SEAS price: $0.2582 (+7.1% over 24h)
- Market cap: $132,266,694; pool liquidity: $1,216,613; DEX volume 24h: $6,997
- Network APY (30-day, the figure the terminal shows): 28.8%
- Paid to Directors since the first payout: $388,235 over 95 payouts
- Last payout: Wednesday, November 4, 2026 at 10:12 AM UTC, $6,628
- Next payout: Sunday, November 8, 2026 at 12:00 PM UTC (Directors are paid every Sunday and Wednesday at 12:00 UTC)
- Nodes earning: 530 (382 Director, 148 Builder)
- Holders: 6,972
- Supply: 304,137,025 $SEAS circulating, 600,309,014 held by the treasury

## How Seasons works

1. **Every trade pays 10%.** The Transactional Transfer Tax (TTT) takes 10% of every $SEAS buy, sell and transfer. The tax on buys and sells is the network's income, so it grows with trading.
2. **The YMS collects it.** The Yield Management System (YMS) runs the whole cycle. It gathers the income, checks which wallets qualify as nodes, and sizes every payout.
3. **SSYM lends it while it waits.** Between payouts the income waits in stablecoins. The Stakeholder Stablecoin Yield Module (SSYM), now in testing, lends them on Kamino and Jupiter Lend. Part of the interest is added to payouts, the rest grows its reserve and buys back $SEAS.
4. **YAV will put assets to work.** Coming next: Yield Asset Vaults (YAV) will run payout assets through DeFi strategies such as liquidity pools. Anyone can deposit for a fee, and part of what the vaults earn is added to payouts.
5. **Directors get the basket, straight to the wallet.** Before each payout the income is swapped into the basket: 30% gold, 30% bitcoin, 40% dollars. A wallet holding 10,000+ $SEAS is a Director node, and the basket lands in it every Sunday and Wednesday. Nothing to claim.
6. **Builders earn $SEAS every week.** A wallet holding 1,000+ $SEAS is a Builder node. It earns 80% of the network rate, paid in $SEAS from a subsidy pool, and claims it to the wallet each Sunday.
7. **Partner tokens come on top.** Partner projects can airdrop their own tokens to node wallets, on top of the yield: Directors by default, Builders sometimes. No lock-up and no custody: every payout stays in your own wallet.

## Nodes and tiers

There are two kinds of node, decided by the balance a wallet holds. One wallet is one node, whatever its size.

- **Builder**: 1,000–9,999 $SEAS. Earns $SEAS every week at 80% of the network rate, from a subsidy pool, and claims it each Sunday.
- **Director**: 10,000+ $SEAS. Receives the basket (30% gold, 30% bitcoin, 40% dollars) every Sunday and Wednesday, in proportion to its balance. Nothing to claim.

Within each kind, a tier is reached by holding its balance for its number of days (Builders also need a number of weekly claims); every tier below counts. Reaching one brings a badge (minted as an NFT for Directors), a one-off $SEAS bonus with the transfer tax covered, and 100,000 EXP. Tiers belong to the address for good; dropping below a tier's balance restarts its count. Days held are per wallet and private to the person, so the network-wide figures group nodes by balance, never by tier held. The seniority boost and EXP are a test and may change.

### Builder ladder

| Tier | Balance ($SEAS) | Days held | Weekly claims | Bonus ($SEAS) | Also |
|---|---|---|---|---|---|
| Basic | 1,000 | 0 | 0 | 0 |  |
| Grower | 1,000 | 60 | 8 | 10 |  |
| Cruiser | 1,100 | 14 | 2 | 10 |  |
| Driver | 2,500 | 30 | 4 | 25 |  |
| Flourish | 4,444 | 44 | 6 | 50 |  |
| Pouncer | 5,000 | 90 | 12 | 100 |  |
| Forward | 7,000 | 180 | 25 | 200 | +25 $SEAS every 28 days |
| Momento | 8,888 | 365 | 52 | 175 | +175 $SEAS more, 14 days later |

### Director ladder

| Tier | Balance ($SEAS) | Days held | Bonus ($SEAS) | Also |
|---|---|---|---|---|
| Basic | 10,000 | 0 | 0 |  |
| Liquidiator | 10,000 | 60 | 10 |  |
| Strider | 11,000 | 14 | 50 |  |
| Tide Hunter | 25,000 | 30 | 125 |  |
| Streamer | 50,000 | 60 | 250 |  |
| HydroSage | 100,000 | 90 | 500 | A shout-out from Seasons |
| Leigonaire | 250,000 | 180 | 1,250 | A shout-out; A partner reward, up to $250 |
| Flow Lord | 1,000,000 | 365 | 7,777 | A shout-out; A partner reward, up to $500 |
| Archillect | 4,444,444 | 444 | 44,444 | A shout-out; A partner reward, up to $4,444 |

## The $SEAS token

- Mint (Solana): `7GdpaeSzvkx1a78rRkU11KstM1x8naMmMmmpWQnQSEAS`
- Transfer tax: 10% of every buy, sell and transfer ([why](https://seasons.gitbook.io/seasons-docs/protocol/seas-token))
- Where to buy: in the terminal (Buy $SEAS, see below), or:
  - [Jupiter](https://jup.ag/swap/SOL-7GdpaeSzvkx1a78rRkU11KstM1x8naMmMmmpWQnQSEAS): every pool, best route
  - [Raydium](https://raydium.io/swap/?inputMint=sol&outputMint=7GdpaeSzvkx1a78rRkU11KstM1x8naMmMmmpWQnQSEAS): swap
  - [Meteora](https://app.meteora.ag/dammv2/D12EGYWwgj7S981m6rbvs8LJrWo6s9JZVNVpLDHiHVbJ): the DAMM v2 pool
  - [Birdeye](https://birdeye.so/token/7GdpaeSzvkx1a78rRkU11KstM1x8naMmMmmpWQnQSEAS?chain=solana): chart and swap
  - [DEX Screener](https://dexscreener.com/solana/7GdpaeSzvkx1a78rRkU11KstM1x8naMmMmmpWQnQSEAS): chart and pairs

## Pages

- [Dashboard](https://fidelius.network/): for a visitor, what Seasons is, the network's headline figures, an earnings calculator and "Choose your node"; for a signed-in node, its own dashboard.
- [Network](https://fidelius.network/network): the same for everyone: a map of every node by balance (addresses masked, balances shown as bands), payouts to the network, the basket, where yield comes from, the two kinds of node and the $SEAS market.
- [Support](https://fidelius.network/support): Gaia, the Seasons AI, and the community.
- [Terms](https://fidelius.network/terms): terms of use.
- [Privacy](https://fidelius.network/privacy): privacy policy.
- Pro (`/pro`, `/pro/node`, `/pro/tiers`, `/pro/network`, `/pro/pools`) and Settings need a signed-in account with a wallet; a visitor is sent back to the dashboard.

## Where each figure comes from

| On screen | Endpoint | Field |
|---|---|---|
| Network APY (30-day) | [/api/public/v1/yield/summary](https://fidelius.network/api/public/v1/yield/summary) | data.apy.terminalDisplayed30dPercent; rolling per-round means are in avg7d/avg30d/avg12m/allTime |
| Paid to Directors | [/api/public/v1/stats](https://fidelius.network/api/public/v1/stats) | data.totalYieldUsd (and data.distributionsCount) |
| Nodes earning, Director and Builder | [/api/public/v1/nodes](https://fidelius.network/api/public/v1/nodes) | data.directors.count, data.builders.count, data.all.count (data.total is the Directors only, as is data.nodes on /v1/stats) |
| Pool liquidity, $SEAS price, market cap, 24h volume | [/api/public/v1/market](https://fidelius.network/api/public/v1/market) | data.liquidityUsd, data.priceUsd, data.marketCapUsd, data.volume24hUsd |
| Price chart | [/api/public/v1/market/chart](https://fidelius.network/api/public/v1/market/chart) | data.candles, range 1H/1D/1W/1M/1Y/ALL |
| Next payout | (no endpoint) | every Sunday and Wednesday at 12:00 UTC |
| Payouts to the network, the latest payout | [/api/public/v1/distributions](https://fidelius.network/api/public/v1/distributions) | data.items; /distributions/latest for the newest |
| The basket, paid per asset | [/api/public/v1/yield/by-asset](https://fidelius.network/api/public/v1/yield/by-asset) | one row per (season, asset) |
| APY history | [/api/public/v1/yield/apy-history](https://fidelius.network/api/public/v1/yield/apy-history) | window 12m or all |
| $SEAS moved on-chain (the flow card) | [/api/public/v1/volume](https://fidelius.network/api/public/v1/volume) | on-chain transfers, not DEX trades |
| The node map's balance bands | [/api/public/v1/network/balances](https://fidelius.network/api/public/v1/network/balances) | counts per band; no addresses |
| Holders, supply, epoch | [/api/public/v1/stats](https://fidelius.network/api/public/v1/stats) | data.holders, data.supply, data.currentEpoch |

## API reference

Base: https://fidelius.network/api/public/v1 (the manifest, as JSON). none — public, rate limited by IP. GET only.

- Envelope: `{ data, meta }`; `meta` carries generatedAt, ttlSeconds, degraded and unavailable (the fields whose source is down).
- Errors: `{ error: { code, message, retryAfterSeconds? } }`, codes unknown_parameter, invalid_parameter, rate_limited, upstream_unavailable, internal_error.
- Rate limit: 120 requests a minute per IP overall, 60 per endpoint (market/chart 30); headers X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, Retry-After.
- Unknown query parameters are rejected with 400 rather than ignored. Timestamps are ISO-8601 UTC strings; missing values are explicit null — keys are never omitted.

Definitions:

- **node**: A wallet holding at least 1,000 $SEAS: a Builder from 1,000, a Director from 10,000. One qualifying wallet is one node regardless of size; the relative size of a Director is expressed as weight = balance / 10,000. minSeasPerNode is the Director floor, kept under its historical name; minSeasPerBuilder is the Builder floor.
- **directors**: Wallets holding at least 10,000 $SEAS that received the most recent completed distribution. Paid Sunday and Wednesday in a basket of gold, bitcoin and dollars, in proportion to weight.
- **builders**: Wallets holding 1,000–9,999 $SEAS (treasury, contracts and blacklisted wallets excluded). Paid in $SEAS, claimed weekly. They carry no basket weight.
- **tiers**: Tiers within each kind need a balance held for a number of days (Builders also a number of weekly claims). Days held are per wallet and not published, so network-wide figures group by balance, never by tier held.
- **transfers**: Counts of $SEAS token_transfers rows. These are transfer records, not Solana transaction counts.
- **transferVolume**: On-chain $SEAS moved between wallets. Distinct from market.volume24hUsd, which is DEX trade volume.
- **season**: A named Inclusion Set era. Endpoints that name individual assets tag each row with a season id, because consecutive sets share no assets and only rows within one season are comparable. No epoch is ever withheld — every season is published, and totals across all of them are all-time.

| Endpoint | Params | Cache (s) | Per minute | What |
|---|---|---|---|---|
| [/api/public/v1](https://fidelius.network/api/public/v1) | – | 3600 | 60 | This manifest: every endpoint, its parameters, cache TTL and rate limit. |
| [/api/public/v1/stats](https://fidelius.network/api/public/v1/stats) | – | 10 | 60 | Headline protocol snapshot: holders, Director nodes, epoch, supply, all-time yield and $SEAS transfer counts. nodes, nodeTotalSeas and nodeTotalWeight are the Directors; /v1/nodes has the Builders too. |
| [/api/public/v1/supply](https://fidelius.network/api/public/v1/supply) | – | 3600 | 60 | Circulating vs locked (treasury-held) $SEAS supply. |
| [/api/public/v1/nodes](https://fidelius.network/api/public/v1/nodes) | – | 300 | 60 | Node network aggregate, Directors and Builders. A Director is a wallet holding at least 10,000 $SEAS that received the most recent completed distribution; a Builder is a wallet holding 1,000–9,999 $SEAS. One wallet is one node, not a 10,000-$SEAS lot. total is the Directors (as it always was); all counts both kinds. |
| [/api/public/v1/network/balances](https://fidelius.network/api/public/v1/network/balances) | – | 300 | 60 | Node counts per balance band (the balance each tier asks for), Builders and Directors. Counts only: no addresses or balances. |
| [/api/public/v1/distributions](https://fidelius.network/api/public/v1/distributions) | limit, offset | 300 | 60 | Completed distributions, newest first, with per-asset amounts, USD totals and the season that paid them. limit 1-100 (default 25), offset >= 0. |
| [/api/public/v1/distributions/latest](https://fidelius.network/api/public/v1/distributions/latest) | – | 300 | 60 | The most recent completed distribution, with the season that paid it. |
| [/api/public/v1/yield/summary](https://fidelius.network/api/public/v1/yield/summary) | – | 60 | 60 | All-time distributed value, distribution and recipient counts, and the APY set (live, 7d, 30d, 12m, all-time) for a single 10,000 $SEAS node. |
| [/api/public/v1/yield/by-asset](https://fidelius.network/api/public/v1/yield/by-asset) | – | 300 | 60 | Distributed yield per Inclusion Set asset over 7d / 30d / all-time windows, one row per (season, asset). Nothing is withheld: summing usdAllTime over every row gives the all-time total. |
| [/api/public/v1/yield/apy-history](https://fidelius.network/api/public/v1/yield/apy-history) | window | 600 | 60 | Per-round APR series for a single 10,000 $SEAS node. window: 12m (default) or all. |
| [/api/public/v1/volume](https://fidelius.network/api/public/v1/volume) | range | 3600 | 60 | On-chain $SEAS transfer volume, bucketed. This is NOT DEX trade volume. range: 1d, 1w (default), 1m, all. |
| [/api/public/v1/market](https://fidelius.network/api/public/v1/market) | – | 3600 | 60 | $SEAS market data aggregated across DEX Screener pairs: price, market cap, FDV, liquidity and 24h trade volume. |
| [/api/public/v1/market/chart](https://fidelius.network/api/public/v1/market/chart) | range | 300 | 30 | $SEAS OHLCV candles. range: 1H, 1D, 1W (default), 1M, 1Y, ALL. |

Not available: Top-nodes leaderboard (per-wallet addresses and balances) (Deferred until the API supports authentication.)

## How to do things on the terminal

These are the steps a person takes, with the labels they will see on screen. You can't sign in, sign or pay for them. Walk them through it instead.

### Sign in or create an account

Open the terminal and press **Sign in** (top right, or in the hero on the home page). The **Sign in to Seasons** window offers four ways in. Any of them creates the account the first time, except a passkey.

1. **Continue with Google.** Google's own window asks which account to use. A Google sign-in joins an existing Seasons account with the same confirmed email, or opens a new one.
2. **Continue with a Solana wallet.** This takes two steps, and neither costs anything:
   - **1 Connect.** Pick the wallet from the list. Any browser-extension wallet (Phantom, Solflare, Backpack and others) is found automatically. The wallet shares only its public address.
   - **2 Sign in.** Press **Sign message**. The wallet shows a sign-in message. Signing it is free, sends no transaction and can't move funds.
   - On a phone, use the wallet app's own browser: the list offers **Open in app** for Phantom, Solflare and Backpack. On Android there is also the **Android wallet chooser**.
   - If the list says **No wallet found**, the device has no Solana wallet. Install Phantom or Solflare first, or use Google or email instead.
3. **Email and password**, under "or with email":
   - To make a new account, choose **Create an account**. The password needs at least 10 characters. Seasons emails a confirmation link, valid for an hour.
   - **Forgot password?** sends a reset link, valid for fifteen minutes.
   - Five wrong passwords lock that email out for fifteen minutes.
4. **Use a passkey.** This only signs in to an account that already has one. Add a passkey in **Settings** first.

A session lasts 30 days. **Settings** lists the account's sessions, and they can be ended one by one or all at once. Settings also adds or removes sign-in methods. The last way into an account can't be removed.

### Link the wallet that holds your $SEAS

An account shows a node's figures once the wallet holding the $SEAS is linked. After that the figures show from any device, with nothing connected.

1. Signed in, open the wallet or account menu and choose **Link a wallet**. The home page's **Link a wallet** card works too.
2. Pick the wallet. It is the same picker as for signing in.
3. Sign the free message "Link this wallet to your Seasons Terminal account." to prove the wallet is yours (**Prove this wallet is yours**). This is needed only once per wallet.

An account can link several wallets. The wallet menu switches which one is being viewed.

If the terminal says **Reconnect your wallet**, the account is fine, but this browser has no live connection to the wallet it needs to sign with. Pick that wallet again. There is no message to sign this time.

If the wallet extension is open on a different account than the one being viewed, the wallet pill shows a warning dot. Its menu offers to view that wallet instead (if it is linked), to link it, or to sign in with it.

### Get a Seasons wallet (no extension, no seed phrase)

A Seasons wallet is a Solana wallet of the person's own, kept by Turnkey. Seasons never holds its key, and it is free for the person.

1. Signed in, choose **Get a Seasons wallet**. It is on the home page's link card, in the account menu, and in Settings → Wallets.
2. Confirm it is you:
   - With a Google account, the key is that Google sign-in. Google asks once, and the browser then stays unlocked for the wallet for a week.
   - With an email account, a six-digit code is emailed. Enter it under **Confirm it's you**.
3. The wallet appears as "My Seasons wallet". It can receive $SEAS, buy $SEAS by card, and claim.

To take the wallet elsewhere, use **Export private key** in Settings, then **Show my key**. Turnkey shows the key inside its own frame, so it never passes through Seasons. It can then be imported into Phantom or Solflare ("Import private key"). Anyone with that key controls the wallet. Export it before deleting a Seasons account.

### Buy $SEAS

Press **Buy $SEAS**: in the $SEAS menu at the top, on the market card, or on the node cards. The buy window picks one path:

- **Swap in the terminal.** Shown when the wallet already holds at least 1 USDC, or about 0.017 SOL or more (0.012 SOL is kept back for fees).
  - Pick an amount. The tiles aim at a node: **To start**, **Builder node** (1,000 $SEAS), **Director node** (10,000 $SEAS), **Your next tier**.
  - Check the figures: You receive at least, Price impact, Jupiter fee, Network fee, Seasons fee.
  - Press **Swap for $SEAS** and confirm in the wallet.
  - The swap runs through Jupiter. The person's own wallet signs it, and Seasons never holds funds.
- **Pay by card.** Offered to Seasons wallets, in countries MoonPay serves, for $21 to $30,000.
  - **Continue to MoonPay** opens MoonPay in a popup, where payment and identity checks happen. The card fee is shown there.
  - Dollars arrive in the wallet as USDC first. A second step then swaps them into $SEAS, and that needs the person's own tap.
- **Other places to buy.** Always listed. It is the whole window when neither path is available.

Every $SEAS buy, sell and transfer pays the 10% transfer tax. Seasons adds no fee of its own; Jupiter's 0.1% is the only extra. The receipt shows only once the swap is confirmed on Solana. If Solana is still confirming, the window says so instead.

Common messages:

- **A little SOL is needed**: about 0.005 SOL pays the network fee.
- **The price moved**: the quote expired before it was sent, and nothing was spent. Get a new quote.
- **No route right now**: Jupiter found no route. Try another amount, or a venue.
- **Cancelled**: the person declined in their wallet, and nothing was sent.
- **The terminal stopped this swap**: Jupiter did not answer after the swap was sent, so it may still land. Check the wallet before buying again.
- **Card purchases are not available here**: the card path is closed for this country or wallet. Swap, or use a venue.

### Claim weekly $SEAS (Builders)

A Builder node (1,000–9,999 $SEAS) earns $SEAS each week and claims it. Directors have nothing to claim: their payouts land in the wallet on their own.

1. Switch to **Pro** (the Lite/Pro switch in the sidebar or the account menu) and open **My node**.
2. Once the week is published the claim card says **Claims open**. Press **Claim … $SEAS** and approve the transaction in the wallet, or confirm with the Seasons wallet.
3. A claim never expires. It costs a small Solana network fee. The very first claim also creates a small on-chain record (about 0.0008 SOL, once).

### Lite and Pro

- **Lite** is the default: a dashboard and the network.
- **Pro** is a node's workspace:
  - **My node**: payouts, claims, cost basis and tax.
  - **Tiers & NFTs**: the ladders, and how far the wallet has climbed.
  - **Network**.
  - **Pools**: the official liquidity pools.
- Pro needs a signed-in account with a wallet. A visitor who picks Pro sees what it is, then the sign-in.

### Get help

**Support** (`/support`) has **Ask Gaia**, Seasons' AI assistant, and the community on Telegram. Gaia also opens from the sidebar. Never share a seed phrase or a private key with anyone. Seasons will never ask for one.

## Documentation and community

- [Become a partner](https://access.seasons.wtf/apply): Bring your community, earn from its activity
- [Partner dashboard](https://partners.seasons.wtf/): For approved partners
- [Documentation](https://seasons.gitbook.io/seasons-docs): How nodes and payouts work
- [Blog](https://seasons.wtf/blog): Weekly updates and reports
- [FAQ](https://seasons.wtf/resources/faqs): Short answers
- [$SEAS token and the transfer tax](https://seasons.gitbook.io/seasons-docs/protocol/seas-token)
- [X](https://x.com/SEAS_onchain)
- [Telegram](https://t.me/SeasonsCommunity)
- [LinkedIn](https://www.linkedin.com/company/seasons-seas)
- [YouTube](https://www.youtube.com/@SEAS_onchain)
- [Medium](https://medium.com/seasons-blog)