# FortiBlox Documentation URL: /docs > Complete documentation for FortiBlox products and services — FortiSwap, FortiSwap Pro and X1 Explorer for the X1 blockchain ecosystem.

All docs

FortiBlox Documentation

Welcome to the comprehensive documentation for FortiBlox products and services on the X1 blockchain.

## Our Services ## Quick Start Guides ## Popular Resources ### FortiSwap Pro * **[Telegram Bot](https://t.me/fortiswap_bot)** - Launch the trading bot on Telegram * **[Trading Dashboard](https://pro.fortiblox.com)** - Access the web dashboard * **[Copy Trading](/docs/pro/copy-trading)** - Mirror successful traders * **[Token Sniping](/docs/pro/sniping)** - Snipe new token launches ### X1 Explorer * **[Account Lookup](/docs/explorer/accounts)** - Search wallet addresses * **[Gas Tracker](/docs/explorer/gas-and-fees)** - Network gas insights
--- # X1 Explorer URL: /docs/explorer > A companion guide to the X1 Explorer — explore the X1 blockchain, track your portfolio, stake, and more.
Search the chain, read transactions, track tokens and NFTs, browse validators, stake your XNT, and follow your whole portfolio in one place — all with live, on-chain data.} ctaHref="/docs/explorer/getting-started" ctaLabel="Start with Getting started" /> ## What this guide is This guide is a companion to the Explorer: it walks through each area and shows you how to get the most out of it. You don't need an account to explore, and connecting a wallet is optional — it only unlocks your personal views (portfolio and staking). Start with the [Introduction](/docs/explorer/intro) for an overview of each area. The Explorer is **read-only**. Even when you connect a wallet, it never moves your funds — any action that touches your assets (like staking) always goes through your wallet's own approval.
--- # Accounts & Addresses URL: /docs/explorer/accounts > Look up any X1 address to see its balance, token holdings, transaction history, and NFTs. # Accounts & Addresses Every wallet, token account, and program on X1 has an **address**. Paste any address into search — or open one from a transaction — to see everything about it. ## What an Account Page Shows ### Balances * The account's **XNT balance** * **Portfolio value** — an estimate of total holdings * **Stake** — any **Active Stake** and **Inactive Stake** the account holds ### Token Holdings Every token the account holds, with amounts. Use **Hide Spam** to filter out unwanted or junk tokens, so you only see what matters. ### Account Activity A full **transaction history** for the address, showing each transaction's **hash**, **slot**, fee, and **last activity** time. You can: * **Expand** a row to see more detail * **Export CSV** to download the history * Filter out spam and noise The activity view updates **live**, so new transactions appear as they happen. ### NFTs Any NFTs the account owns are shown with their artwork and collection. ### Programs & Rent For program or data accounts you'll also see details like **data size**, **rent status**, and the **programs** involved. ## Looking Up Any Address 1. Copy an address (from a wallet, a transaction, or anywhere). 2. Paste it into the search bar. 3. You land on that account's page instantly. ## Your Own Wallet Want a richer, personalized view of your own wallet — net worth over time, DeFi positions, staking rewards, and P\&L? Connect your wallet and open the [Portfolio](/docs/explorer/portfolio-overview) instead. > **Tip:** The account page is address-agnostic — you can inspect *any* wallet on X1, not just your own. Great for researching a token deployer or a validator's operator wallet. --- # API Access URL: /docs/explorer/api-access > Access X1 Explorer data programmatically through the REST API. # API access Everything you see in the explorer is also available programmatically, so you can build your own dashboards, bots, and integrations on top of X1 data. ## Getting started Browse the interactive **[API docs](https://explorer.fortiblox.com/docs/api)** in the explorer to see the available endpoints and try them live. The API covers the same data the explorer uses, including: ## Using the API * Endpoints return JSON and can be called from any language. * Responses mirror what the explorer displays, so what you build stays consistent with the UI. * For higher volume or production use, reach out through **[Support](https://discord.gg/3THDDnSkZk)** to discuss access tiers. The full, always-current endpoint list lives in the **[interactive API docs](https://explorer.fortiblox.com/docs/api)** inside the explorer — start there to explore and test requests. --- # Ask X1 (Forti) URL: /docs/explorer/ask-x1 > Ask X1 is a built-in AI companion that answers questions about live X1 blockchain data in plain English. # Ask X1 — your on-chain companion **Ask X1** is the chat companion in the bottom-right corner of the explorer, powered by **Forti**. Ask it anything about X1 in plain English and it answers using real, live on-chain data. > Hi, I'm Forti — your X1 Blockchain companion. Ask me about validators, tokens, staking, NFTs, the network, or anything on the explorer. ## What you can ask Forti understands natural-language questions across the whole explorer: ## How it answers * **Grounded in real data.** Forti reads the same live on-chain data the explorer shows — it doesn't make numbers up. If there's no data for something, it says so rather than guessing. * **Readable answers.** It turns raw addresses and on-chain records into plain-English explanations, with clickable cards for the validators, tokens, and programs it mentions. * **Remembers your conversation.** Follow-up questions keep the context of what you were just asking about. ## Good to know Ask X1 is **read-only** and **informational**. It explains on-chain data — it is **not financial advice**, and it can never move funds or make transactions. Always do your own research before making decisions. To use it, click the Forti icon in the bottom-right corner, type your question, and press Enter. --- # Blocks URL: /docs/explorer/blocks > Browse blocks as they're produced and read the details of any block on X1. # Blocks A **block** is a batch of transactions confirmed together by the validator that was leader for that slot. The Blocks page shows them live as the network produces them. ## The Blocks List Go to **Blocks** in the top navigation for a real-time list. Each entry shows: * **Slot** — the block's position in the chain * **Block Hash** — its unique identifier * **Validator** — the leader that produced it * **Transactions** — how many transactions it contains * **Reward** — the reward earned for producing it * **Size** and **Gas Used** — how full the block was * **Time** — when it was produced New blocks stream in at the top automatically. ## Opening a Block Click any block (or search its slot number) to open its detail page. There you'll see: * The block's **slot**, **hash**, and **parent** block * The **validator** that produced it * The **timestamp** and **block height** * The full **list of transactions** in the block From there you can click straight through to any transaction to inspect it. ## Reading Block Timing X1 produces blocks quickly, so the list updates constantly. The time column tells you how recently each block landed — handy for confirming the network is healthy and current. > **Tip:** Want the bigger picture instead of individual blocks? The [Analytics](/docs/explorer/network-analytics) area shows block production and network throughput over time. --- # Connecting Your Wallet URL: /docs/explorer/connect-wallet > Connect an X1 Wallet or Backpack to view your portfolio and stake — the explorer stays read-only otherwise. # Connecting your wallet Connecting a wallet unlocks the personal features of the explorer — your **portfolio**, your **transaction history**, and **staking** — all tied to your own address. It's optional: you can explore everything else without connecting. ## Supported wallets ## How to connect 1. Click **Connect Wallet** (top-right of the explorer). 2. Pick **X1 Wallet** or **Backpack** from the list. 3. Approve the connection in your wallet's popup. Once connected, you'll see your address and net worth in the header, and the **Portfolio** and **Staking** areas become personalized to you. ## What connecting enables * **Portfolio** — your net worth, token holdings, NFTs, DeFi positions, and full transaction history * **Staking** — delegate XNT to a validator and track your rewards **The explorer stays read-only.** Connecting only lets the explorer *read* your public on-chain data to show your portfolio. It can never move your funds — any action that touches your assets (like staking) always requires you to approve it in your own wallet first. ## Disconnecting Click your address in the header and choose **Disconnect** at any time. Your data isn't stored — the view simply clears. --- # DeFi & XDEX URL: /docs/explorer/defi-xdex > Explore liquidity pools and DeFi activity on X1 through the XDEX view. # DeFi & XDEX The **DeFi** area surfaces on-chain decentralized-finance activity on X1, centered on **XDEX** — the X1 automated market maker (AMM). ## The XDEX View Open **DeFi → XDEX** to see the DEX landscape: * **Active LP Pools** — liquidity pools currently on X1 * **Pool Coverage** — how much of the DEX is represented * **Active Stakers** — participants providing liquidity * Per-pool details: the **pool** pair, **price**, and **reserves** (Reserve A / Reserve B) ## Reading a Pool Each pool represents a trading pair backed by two token reserves. The **reserves** tell you how much of each token backs the pool, and the **price** reflects the ratio between them. Larger reserves generally mean deeper liquidity and less slippage on trades. ## Following Swaps DEX swaps you find here connect back to the [transaction view](/docs/explorer/transactions) — open any swap to see the exact tokens and amounts that moved. > **Note:** Some DeFi analytics are still being expanded, and the XDEX view may show a development notice on certain panels while coverage grows. Pool listings and reserves reflect real on-chain state. --- # Delegation Program URL: /docs/explorer/delegations > See which validators receive stake from the X1 Delegation Program, how much, and the criteria a validator must meet to qualify. # 🏛️ Delegation Program The **Delegations** page (`/delegations`) shows the **X1 Delegation Program** — the foundation-run stake pool that delegates XNT to validators who meet the network's health and performance standards. ## What it shows Each validator in the program is listed with: * **Program stake** — the amount delegated to this validator *through* the Delegation Program. * **Self / community stake** — the validator's own stake plus delegations that don't come from the program. * **Total stake** — the sum of everything staked to the validator. * **Commission**, **skip rate**, and **status** — the performance signals used to judge eligibility. A visual breakdown lets you compare how the program's stake is distributed across validators at a glance. ## Eligibility criteria To receive Delegation Program stake, a validator must meet **all** of these on-chain criteria: * **Active** — currently voting and producing blocks. * **Commission ≤ 10%** — keeps costs low for the pool. * **Self-stake ≥ 2 XNT** — the operator has skin in the game. * **Total stake ≤ 10M XNT** — keeps stake from concentrating. * **Vote credits ≥ 97%** — reliably voting. * **Skip rate ≤ 10% above the network average** — consistently producing blocks. Membership status comes from the foundation's authoritative delegation records, shown alongside an independent on-chain check of whether each validator currently meets the criteria — so you can see both the official status and the live picture. This page is informational — it reflects how the foundation allocates program stake. To stake your **own** XNT to any validator, see [Staking](/docs/explorer/staking). --- # Gas & Fees URL: /docs/explorer/gas-and-fees > Understand X1 transaction fees and priority fees with the X1 Explorer Gas Tracker. # Gas & fees X1 fees are low, but knowing the current rates helps you set the right priority fee when the network is busy. The **Gas Tracker** shows live fee data straight from recent blocks. ## What the Gas Tracker shows * **Avg Fee** — the typical base fee per transaction right now * **Min Fee** / **Max Fee** — the range seen in recent blocks * **Priority Fee** — the extra fee that gets a transaction included faster (shown as **Avg**, **Min**, and **Max Priority**) ## How fees work on X1 Every transaction pays a small **base fee**. When you want faster inclusion during busy periods, you can add a **priority fee** — a tip that incentivizes validators to pick up your transaction sooner. Priority fees are measured per unit of compute. Most of the time the standard fee is more than enough. Only raise your priority fee when the tracker shows fees climbing and you need a time-sensitive transaction to land quickly. ## Where to find it Open **Gas Tracker** from the navigation, or check the **Fee Tracker** under **Analytics** for fee trends over time. --- # Getting Started URL: /docs/explorer/getting-started > First steps with X1 Explorer — navigate the X1 blockchain, search anything, and find your way around. # Getting Started with X1 Explorer X1 Explorer is your window into the **X1 blockchain**. Look up any address, transaction, block, token, validator, or program — and go deeper with portfolio tracking, staking, validator analytics, and an AI assistant. Everything here is **read-only** unless you choose to connect a wallet. You can browse the entire chain without signing in. ## Opening the Explorer Head to the Explorer and you'll land on the **Dashboard** — a live overview of the X1 network: recent blocks, latest transactions, network activity, and key stats. The network selector at the top confirms you're on **Mainnet**. ## The Top Navigation The main menu gives you quick access to every area: * **Dashboard** — live network overview * **Blocks** — the latest blocks as they're produced * **Transactions** — the live transaction feed * **Assets** — tokens and NFTs on X1 * **Validators** — the validator directory and detail pages * **Analytics** — network stats, TPS, fees, XNT tokenomics, and more * **Portfolio** — track a wallet's holdings, activity, staking, and P\&L ## Searching for Anything At the top of every page is the **universal search bar**. Paste in almost anything and the Explorer figures out what it is and takes you to the right page: * A **wallet address** * A **transaction signature** * A **block** number * A **token** mint * A **validator** * A **program** See [Search](/docs/explorer/search) for tips. ## What You Can Do * **Explore** blocks, transactions, and accounts in detail * **Track tokens** — prices, holders, supply, and transfers * **Research validators** — performance, commission, APR, and rewards * **Stake** your XNT and watch your rewards accrue per epoch * **Manage a portfolio** — net worth, assets, DeFi, transactions, and NFTs * **Ask Forti**, the built-in AI assistant, questions in plain English ## Do You Need to Connect a Wallet? No — browsing is fully open. **Connecting a wallet** simply unlocks personalized views (your portfolio and staking). The Explorer never takes custody of your funds. See [Connecting Your Wallet](/docs/explorer/connect-wallet) when you're ready. > **Tip:** Bookmark the addresses and validators you care about by searching them — you can jump straight back anytime. --- # Introduction URL: /docs/explorer/intro > A companion guide to the X1 Explorer — explore the X1 blockchain, track your portfolio, stake, and more. # X1 Explorer X1 Explorer is the blockchain explorer for the **X1** network. Use it to search the chain, read transactions, track tokens and NFTs, browse validators, stake your XNT, and follow your whole portfolio in one place — all with live, on-chain data. This guide is a companion to the Explorer: it walks through each area and shows you how to get the most out of it. You don't need an account to explore, and connecting a wallet is optional — it only unlocks your personal views (portfolio and staking). ## What you can do Search any address, transaction, block, token, validator, or program — and read it in plain language. Net worth, holdings, staking, DeFi, and a full transaction history for any wallet. Delegate to a validator, watch your rewards accrue each epoch, and unstake when you want. Ask questions about the network in plain English — the built-in assistant answers from live data. ## How this guide is organized * **Getting started** — the basics: navigation, search, and connecting a wallet. * **Explore** — blocks, transactions, accounts, tokens, DeFi, and programs. * **Validators & staking** — the validator directory, validator profiles, how to stake, and reading your rewards. * **Portfolio** — your net worth, assets, transactions, DeFi/staking positions, and multi-wallet views. * **NFTs** — collections, rarity, and individual NFTs. * **Analytics** — network health, XNT tokenomics, and gas/fees. * **Tools** — Ask X1, and API access for developers. ## A note on data Everything in the Explorer is sourced from the X1 blockchain. When a value can't be priced or isn't available yet, the Explorer shows that honestly (for example, "unpriced" instead of a made-up number) rather than guessing. The Explorer is **read-only**. Even when you connect a wallet, it never moves your funds — any action that touches your assets (like staking) always goes through your wallet's own approval. Ready? Start with [Getting started](/docs/explorer/getting-started). --- # Network Analytics URL: /docs/explorer/network-analytics > Track X1 network health, validator distribution, TPS, and consensus on the X1 Explorer. # Network analytics The **Network Stats** and **Analytics** sections give you a live, at-a-glance view of the health and shape of the X1 network. ## Network health The network overview shows the vital signs of X1: * **Active Validators** — validators currently producing and voting * **Delinquent** — validators that have fallen behind * **TPS** — transactions per second the network is processing * **Supply** — total and circulating XNT ## Validator distribution X1's decentralization is easy to read at a glance: ## Deeper analytics The **Analytics** menu breaks the network down further: * **Network Consensus** — real-time consensus and voting health * **Block Production** — how blocks are being produced across validators * **Transaction Activity** — volume and type of on-chain activity over time * **Validator Map** — an interactive world map of validators and their stake Each view updates continuously, so what you see reflects the network right now. --- # NFTs URL: /docs/explorer/nfts > Browse X1 NFT collections, explore rarity rankings, and view individual NFTs on the X1 Explorer. # NFTs The **NFTs** section lets you browse every NFT collection on X1, dig into a collection's items and rarity, and view any individual NFT with its traits and owner. ## Browsing collections Open **NFTs** from the top navigation to see all collections. Each collection card shows: * **Items** — how many NFTs are in the collection * **Owners** — how many unique wallets hold them * **Verified** — a badge on collections that are verified Use the sort control to reorder the grid: ## Inside a collection Click any collection to open its page. Here you can: * **Search items** by name or mint address * **Sort by rarity** to surface the rarest pieces * See each item's **rarity rank** and its image * Switch between **compact** and **large** card layouts Rarity is calculated from how uncommon each NFT's traits are across the collection, so a lower **Rank** means a rarer NFT. ## Viewing a single NFT Open any item to see its full detail page: * The **image** (or video, for animated NFTs) * Its **traits** / attributes * Its **rarity rank** within the collection * The current **owner** **Revealed collections update automatically.** When a collection reveals its art on-chain (for example a timed drop that flips from a placeholder to the final artwork), the explorer picks up the change on its own — no manual refresh needed. --- # Assets & Holdings URL: /docs/explorer/portfolio-assets > See every token and NFT an X1 wallet holds, with live USD valuation, in the Portfolio Assets tab. # Assets & Holdings The **Assets** tab lists everything a wallet holds — tokens and NFTs — with a USD value for each. Open it from **Portfolio → Assets**. ## Holdings list Each holding shows: * **Token or NFT** — its logo, symbol, and name. * **Balance** — how many units the wallet holds. * **Price** — the current unit price, when one is known. * **Value** — the balance multiplied by the price, in USD. Holdings are ordered by USD value, so the wallet's most valuable positions are at the top. ## Priced vs. unpriced Not every token on X1 has a market price. The explorer is honest about this: * **Priced** — a token with a known market price shows a USD value. * **Unpriced** — a token with no reliable price shows a dash instead of a dollar amount. It's still listed and counted in your holdings; it just isn't given a made-up value. This keeps your net worth trustworthy: an unpriced token never inflates or distorts your total. ## Tokens and NFTs together The Assets tab includes both fungible tokens and NFTs the wallet owns. NFTs appear with their collection and item name (for example, a numbered item from a collection). For a richer NFT experience — collection stats, rarity, and artwork — use the dedicated **NFTs** tab (**Portfolio → NFTs**) or the explorer's main **/nfts** section. ## Allocation Your holdings feed the **Allocation** breakdown on the Dashboard tab, which shows what share of your net worth each asset represents. If a large share sits in a single token, you'll see it clearly there. --- # DeFi & Staking Rewards URL: /docs/explorer/portfolio-defi-staking > View your staking positions and per-epoch staking rewards, with historical USD, in the Portfolio DeFi tab. # DeFi & Staking Rewards The **DeFi** tab shows a wallet's staking activity: what it has delegated, and the rewards it has earned. Open it from **Portfolio → DeFi**. It has two sub-tabs: **Positions** and **Rewards**. ## Positions The **Positions** sub-tab lists each of the wallet's stake accounts: * **Validator** — the validator the stake is delegated to (its name when known, otherwise its vote address). * **Amount** — how much XNT is in the stake account. * **Status** — **Active** (earning rewards) or **Deactivating** (in the cooldown before it can be withdrawn). At the top you'll see the **Total Staked** and the number of **Active Stakes**. ## Rewards The **Rewards** sub-tab shows your staking rewards **per epoch** — the same "Rewards by Epoch" view used on validator pages, but for your wallet across all of its stake accounts. For each epoch you can see: * **Reward earned** that epoch, in XNT. * **USD value** at that epoch's own historical price — so it reflects what the reward was worth when you earned it, not today. * **Cumulative rewards** building up over time. Hover the chart for a per-epoch breakdown, including the value in USD and the running total. This makes it easy to see how your staking income has grown epoch over epoch. ## Where the numbers come from Everything here reflects real on-chain staking data. Rewards are the inflation rewards your stake accounts actually earned each epoch. A wallet with no stake accounts simply shows an empty state — nothing is estimated or invented. ## Related * To **start staking**, see the [Staking guide](/docs/explorer/staking) or open a validator's **Stake** page. * For a single validator's own rewards and performance, see its [validator detail page](/docs/explorer/validators). --- # Activity, Positions & Multi-Wallet URL: /docs/explorer/portfolio-multiwallet > Follow live wallet activity, review open positions, and combine multiple wallets into one Portfolio view. # Activity, Positions & Multi-Wallet Beyond holdings and history, the Portfolio includes three more views for a fuller picture. ## Activity The **Activity** tab (**Portfolio → Activity**) is a live feed of the wallet's most recent on-chain activity. Where the Transactions tab is built for browsing and filtering full history, Activity is a streaming, at-a-glance view of what's happening now — new transfers and events as they land. ## Open Positions The **Open Positions** tab (**Portfolio → Open Positions**) surfaces the wallet's current market positions — what it currently holds as active positions rather than its full transaction history. Use it to quickly see where the wallet stands right now. ## Multi-Wallet The **Multi-Wallet** tab (**Portfolio → Multi-Wallet**) lets you combine several wallets into a single aggregated Portfolio. This is useful if you spread activity across multiple addresses and want one consolidated view of: * Combined **net worth** across all added wallets. * Combined **holdings** and **staking**. Add the wallets you want to track together, and the Portfolio totals reflect the whole set instead of a single address. ## Tips * Every Portfolio tab works for **any** address via **Look Up**, not just a connected wallet — so you can inspect any public wallet on X1. * Values are read-only. The Portfolio shows and explains a wallet; it never initiates transfers. --- # Portfolio Overview URL: /docs/explorer/portfolio-overview > Track any X1 wallet's net worth, holdings, staking, and history in one place with the X1 Explorer Portfolio. # Portfolio Overview The **Portfolio** is your all-in-one view of an X1 wallet: what it holds, what it's worth, what's staked, and everything it has done. Open it from the **Portfolio** link in the top navigation, or go to **/portfolio**. ## Loading a wallet There are two ways to view a portfolio: * **Connect Wallet** — connect your own wallet (X1 Wallet or Backpack) to view your live portfolio. * **Look Up** — paste any X1 address into the lookup box to view that wallet's public portfolio (read-only, no connection needed). Either way the Portfolio is read-only — it never moves funds. Connecting simply tells the explorer which wallet to show. ## The header At the top of every Portfolio tab you'll see a summary bar: * **Net Worth** — the total USD value of everything the wallet holds (available balance + staked + tokens). * **Available** — the spendable XNT balance and its USD value. * **Staked** — the total XNT delegated to validators and its USD value. * **XNT Price** — the current price of XNT. Values that can be priced show a USD figure; anything without a known market price is left unpriced rather than showing a fake value. ## Tabs The Portfolio is organized into tabs: | Tab | What it shows | | ------------------ | ---------------------------------------------------------- | | **Dashboard** | Net worth, allocation, and net-worth-over-time at a glance | | **Analytics** | Profit & loss, realized/unrealized gains, and cost basis | | **Assets** | Every token and NFT the wallet holds, with USD valuation | | **DeFi** | Your staking positions and per-epoch staking rewards | | **Transactions** | Full transaction history with filters and columns | | **Activity** | A live feed of recent on-chain activity | | **NFTs** | The wallet's NFT collection | | **Open Positions** | Current market positions | | **Multi-Wallet** | Combine several wallets into one view | ## Dashboard tab The **Dashboard** is the landing view. It brings together: * **Net worth** with the available vs. staked split. * **Allocation** — a breakdown of net worth by asset (for example, XNT staked, XNT available, and each token), shown by share of total USD value. * **Net Worth Over Time** — a chart of the wallet's value across selectable ranges (24H, 1W, 1M, 1Y, ALL). This values the native XNT balance at the XNT price so you can see how the position has moved. ## Analytics tab The **Analytics** tab focuses on performance: * **Profit & Loss (P\&L)** — how the wallet's holdings have gained or lost value. * **Realized vs. unrealized** — gains already locked in versus gains still on paper. * **Cost basis** — what the holdings were acquired for, used to compute P\&L. Use the Analytics tab when you care about *performance*; use the Dashboard when you just want the current picture. --- # Transaction History URL: /docs/explorer/portfolio-transactions > Browse, filter, and understand a wallet's full transaction history with historical USD pricing in the Portfolio Transactions tab. # Transaction History The **Transactions** tab is a complete, filterable history of a wallet's activity, with the USD value of each transaction at the time it happened. Open it from **Portfolio → Transactions**. ## Filtering Narrow the list with: * **Type filters** — **All**, **Received**, **Sent**, **Swaps**, **Transfers**, **Approvals**. * **Date range** — pick a start and end date to focus on a period. * **Search** — search by token, mint, or transaction signature. ## Reading a row Each transaction is shown as a row with aligned columns: * **Type** — an icon for the kind of transaction (transfer, swap, etc.). A failed transaction is flagged with a warning marker. * **Token** — the token involved, with its logo and symbol. * **Amount** — the signed amount (a green **+** for incoming, a red **−** for outgoing). * **USD value** — the value in USD **at the time of the transaction**, with the historical unit price shown in parentheses. Because it uses the price on that day, it reflects what the transfer was actually worth then — not today's price. * **Fee** — the network fee paid, in XNT. * **Counterparty** — the other party in the transfer, shown as **from …** or **to …** and linked to that account. * **Programs** — the on-chain programs the transaction touched. * **Slot** — the slot the transaction landed in, linked to the transaction detail. * **Time** — when it happened, with a link to the full transaction and the data source. Transactions are grouped by day (Today, Yesterday, and dated sections) so it's easy to scan. ## "Unpriced" transactions If a token had no known price at the time of a transaction, its USD column reads **unpriced** rather than showing a fabricated value. The transfer amount is still shown — only the dollar figure is withheld. ## Loading more The list loads in pages. Scroll to the bottom and use **Load more** to fetch older history. When you reach the end you'll see a count and an "end of history" note. --- # Programs URL: /docs/explorer/programs > Browse the on-chain programs powering X1 and inspect any program's activity and details. # Programs **Programs** are the on-chain code (smart contracts) that run on X1 — the token program, the DEX, staking, and everything apps are built on. The Explorer helps you find them and understand what they do. ## The Programs Directory Open **Programs** for a list of programs active on X1. Each entry shows: * The **program** name (a friendly label when known) and its ID * **Category** — what kind of program it is * **Activity Score** and **Success rate** — how active and reliable it is * **Recent activity** and **Last active** time * **Signers** — how many distinct accounts interact with it Programs with recognizable identities show a **friendly name** instead of a raw address, so you can tell at a glance what you're looking at. ## A Program's Page Click a program (or search its ID) to open its detail page: ### Overview * The program **name**, **category**, and **deployment** info * **Data Size** and **Bytecode Hash** ### Activity Stats * **Avg Compute Units** and **Avg Fee / Tx** — how heavy its transactions are * **Fee per CU** * Success vs **Failed** transaction counts * **Last Activity** ## Why This Is Useful When a transaction lists a program you don't recognize, look it up here to learn what it is and how active it is. A high **success rate** and steady **activity** are good signs the program is healthy and widely used. > **Tip:** Not sure what a program does? Ask **Forti**, the built-in [AI assistant](/docs/explorer/ask-x1) — it can explain a program in plain English. --- # Universal Search URL: /docs/explorer/search > Paste an address, transaction, block, token, validator, or program — the Explorer routes you to the right page automatically. # Universal Search The search bar sits at the top of every page. It's **type-aware**: you don't have to tell it what you're looking for — paste a value and it detects the kind and takes you there. ## What You Can Search | Paste this… | You land on… | | ---------------------------------- | ---------------------------------------------------------- | | A wallet **address** | the account page with balances, tokens, activity, and NFTs | | A **transaction signature** | the full transaction breakdown | | A **block** number | that block's details | | A **token** mint | the token page — price, holders, supply, transfers | | A **validator** (vote or identity) | the validator detail page | | A **program** ID | the program page | ## How to Use It 1. Click the search bar (or use the search shortcut). 2. Paste or type your value. 3. The Explorer resolves it and navigates automatically. ## Tips * **Partial names work** for tokens and validators — start typing a name and pick from the suggestions. * **Both validator keys work** — you can search a validator by its vote account *or* its identity (node) key. * If a value could match more than one thing, you'll see options to choose from. * Not sure what you have? Paste it anyway — the placeholder says it best: *"Search anything… we'll figure it out."* > **Tip:** Searching is the fastest way to return to an address or validator you were watching — no need to keep a separate list. --- # Staking XNT URL: /docs/explorer/staking > Delegate your XNT to a validator to earn staking rewards — step by step, plus how to track and unstake. # 🥩 Staking XNT Staking lets you earn rewards by delegating your XNT to a validator that secures the X1 network. Your tokens stay in your control the whole time — you're only delegating them, never giving them away. The staking page lives at `/staking`, or `/stake/` when you arrive from a specific validator. ## How staking works * You **delegate** XNT to a validator of your choice. * The validator earns rewards each epoch and pays them to its delegators, minus its **commission**. * Rewards **accrue automatically** — there's nothing to claim manually. * You can **unstake** at any time; your XNT becomes withdrawable after a short cooldown. ## How to stake You'll need a connected wallet with XNT. See [Connecting Your Wallet](/docs/explorer/connect-wallet). 1. **Connect your wallet** using the button in the top right. 2. Open a validator's page and choose the **Stake** tab (or go to `/staking`). 3. **Enter an amount** to stake. You can also tap **25% / 50% / 75% / 100%** to use a portion of your available balance. 4. Check the **minimum stake** requirement shown below the field and that you have enough XNT left for network fees. 5. Click **Stake** and approve the transaction in your wallet. Your new stake begins **activating** and starts earning once it's fully active (this takes a short warm-up period). ## The staking tabs A validator's staking page has four tabs: * **Stake** — the delegation form plus your existing stake accounts with this validator. * **Analytics** — the validator's real numbers: APR, vote performance, network share, and its rank among all validators. (These reflect live on-chain data, not estimates.) * **History** — your on-chain staking activity with this validator. * **Rewards** — your per-epoch staking rewards. See [Staking Rewards](/docs/explorer/staking-rewards). ## Understanding the numbers * **APR** — your estimated annual return after the validator's commission. * **Commission** — the percentage the validator keeps before paying rewards. * **Network Share / Rank** — how large this validator is relative to the whole network. * **Delegators** — the real number of accounts staking with this validator. ## Unstaking To stop staking, open your stake account and choose **Unstake**. The stake enters a **deactivation cooldown** before the XNT becomes withdrawable. The exact wait depends on how far the current epoch has progressed — the explorer shows you an estimated time. Once cooldown completes, you can withdraw your XNT back to your wallet. Staking rewards and APR vary with network conditions and the validator's performance. Nothing here is financial advice — always do your own research before delegating. --- # Staking Rewards URL: /docs/explorer/staking-rewards > Track the rewards you earn from staking — per epoch, valued at the time they were earned, with a running cumulative total. # 🎁 Staking Rewards Once you're staking, the **Rewards** tab shows exactly what you've earned — the same per-epoch view used for validators, but scoped to *your* stake. You'll find it on the staking page (`/staking` → **Rewards**) and inside the [Portfolio](/docs/explorer/portfolio-overview) DeFi section. ## How rewards work * Rewards are paid **every epoch** to everyone delegating to a validator. * They **accrue automatically** — there's nothing to claim. * The validator's **commission** is taken out before rewards reach you; the amounts shown are what you actually received. * Rewards compound as your active stake grows. ## Reading your rewards Each epoch in the Rewards tab shows: * **Epoch** — the epoch the reward was earned in. * **Amount** — the XNT you earned that epoch. * **USD at the time** — the reward valued at the XNT price on that epoch's own day, so the dollar amount reflects what it was worth when earned (not today's price). * **Cumulative** — a running total of everything you've earned. Hover any point on the chart to see the exact reward, the price used, and your cumulative total up to that epoch. If your Rewards tab looks empty right after you start staking, that's expected — rewards appear once your stake has been active through a completed epoch. ## Rewards across all your stakes In the [Portfolio](/docs/explorer/portfolio-overview), the Rewards view aggregates rewards across **every** validator you delegate to, so you can see your total staking income in one place rather than validator by validator. --- # Tokens URL: /docs/explorer/tokens > Browse tokens on X1 and dig into any token's price, holders, supply, and transfers. # Tokens The **Assets → Tokens** area lists tokens on X1 and lets you drill into any one of them. ## The Token List Open **Tokens** for a sortable directory. Across the top you'll see summary stats like **Active Tokens**, **Total Holders**, **Avg Holders**, and **Avg Price**. For each token the list shows its name, **market cap**, price, and holder counts. You can: * **Filter by Token Type** to narrow the list * Adjust **Columns** to show the data you care about * Sort to find the top tokens by your chosen metric ## A Token's Page Click any token (or search its mint address) to open its detail page: ### Market * Current **price** and a **chart** (hover the chart to read values at a point in time) * **Market cap** and **liquidity** ### Supply & Authorities * **Balance/supply** and **decimals** * Whether it's **Initialized**, and its **Freeze Authority** status (Active / Disabled) — useful for spotting whether a token can be frozen ### Holders * The **Holders** count and top holders * **Concentration** — how much supply the largest holders control * **Holder Snapshots** over time ### Activity * Recent **transfers** and transaction activity, with **Avg Transaction Size** and **Last Activity** Use **Hide Spam** to keep the view clean. ## Reading Concentration & Authorities Two quick signals when researching a token: * **Freeze Authority: Disabled** means no one can freeze holders' tokens. * Low **Concentration** (supply spread across many holders) is generally healthier than a few wallets holding most of it. > **Tip:** Follow a token's transfers to see how it's moving, or jump to a holder's [account page](/docs/explorer/accounts) to research who they are. --- # Transactions URL: /docs/explorer/transactions > Read any X1 transaction — status, fees, balance changes, token transfers, instructions, and logs — and learn to decode a swap. # Transactions Every action on X1 — a transfer, a swap, a stake — is a **transaction**. The Explorer shows you exactly what each one did. ## The Live Feed Go to **Transactions** for a stream of recent activity across the network. Click any row (or search a transaction **signature**) to open its full detail page. ## Reading a Transaction The transaction page is organized top to bottom: ### Overview * **Signature** — the transaction's unique ID * **Status** — **Success** or **Failed** * **Timestamp** — when it was confirmed * **Confirmation Status** — e.g. *finalized* * **Slot** — the block it landed in * **Transaction Fee** and **Fee per CU** (fee per compute unit) * **Compute Units** consumed * **Transaction Version** ### Account Balance Changes A table of every account the transaction touched, showing the **XNT change** (how much each balance went up or down) and the **post balance**. The **fee payer** and **signer** are marked. This is the quickest way to see who paid and who received. ### Token Balances If the transaction moved tokens (not just XNT), you'll see each token account's **change** and **post balance**, with the token's name — so you can read exactly which tokens moved and by how much. ### Instructions The actual steps the transaction performed, each showing the **program** that ran it and its inputs. Recognized programs show a friendly name; unrecognized ones show their program ID. ### Inner Instructions Steps that programs triggered *inside* other steps (for example, a DEX program calling the token program to move funds). These are nested under the instruction that invoked them. ### Program Logs The messages programs emitted while running — useful for understanding what happened and confirming success. ## Worked Example: Reading a Swap Say you open a transaction and the logs show `Instruction: SwapBaseInput`. Here's how to read it: 1. **Account Balance Changes** show a small XNT movement and the fee. 2. **Token Balances** show one token going **down** on your account and another going **up** — that's the swap. 3. **Inner Instructions** reveal the token transfers the DEX made on your behalf (a "TransferChecked" in each direction). 4. The **amounts** in the inner instructions are the exact quantities swapped. Put together: you traded X of one token for Y of another, paid a small fee, and the transaction succeeded. > **Tip:** Amounts are shown in real token units (already adjusted for decimals) — so a value like `0.131801618` means that many tokens, not raw units. --- # Validator Details URL: /docs/explorer/validator-details > Read a validator's full profile — performance, commission, real APR, per-epoch rewards with historical USD, stake breakdown, and its delegators. # 📋 Validator Details Clicking any validator opens its detail page (`/validators/`) — a full profile of how that validator performs and earns. The page is organized into three tabs: **Stake**, **Rewards**, and **Performance**. ## Overview At the top you'll find the validator's identity and headline stats: * **Name & address** — the validator's name and vote account. * **Status** — Active or Delinquent. * **Commission** — the cut the validator takes from rewards. * **APR** — the estimated annual reward rate, derived from real recent on-chain rewards. When there isn't enough reward history yet, it's shown with an **"est."** label so you always know whether the number is measured or estimated. * **Overall Score** — a summary of the validator's reliability. ## 💰 Rewards by Epoch The **Rewards** tab shows the validator's inflation rewards for each epoch: * **Per-epoch amount** — XNT earned that epoch. * **Historical USD** — each epoch's reward valued at the XNT price on that epoch's own day (not today's price), so the dollar figures reflect what the rewards were actually worth when earned. * **Cumulative** — a running total of rewards over time. Hover any epoch on the chart to see its exact reward, the price used, and the cumulative total to that point. ## 🥧 Stake Breakdown The **Stake** tab breaks the validator's total stake into three buckets so you can see where its stake comes from: * **Foundation** — stake delegated by the X1 foundation program. * **Self-stake** — stake the validator operator has committed themselves. * **Community** — stake delegated by everyday users like you. ## 👥 Delegators A paginated list of the accounts delegating to this validator, with each delegator's staked amount. Named accounts show their name; others show their address. ## 📈 Vote Performance History The **Performance** tab shows how consistently the validator has voted over recent epochs — a key signal of reliability. Steady, high vote performance means the validator is earning full rewards and passing them on to delegators. Ready to delegate to this validator? Use the **Stake** button to open the [staking flow](/docs/explorer/staking). --- # Validator Map URL: /docs/explorer/validator-map > See where X1 validators are located around the world and how the network is distributed geographically. # 🌍 Validator Map The **Validator Map** (`/validator-map`) plots the X1 validator network on an interactive world map, so you can see how geographically distributed — and therefore resilient — the network is. ## What it shows * **Validator locations** — each validator that reports a location is placed on the map. * **Geographic distribution** — a quick visual of how spread out (or concentrated) the network is across regions. * **Upcoming leaders** — a sense of which validators are next in line to produce blocks. ## Map & list views Use the toggle to switch between: * **Map view** — the interactive global map. * **List view** — the same validators in a sortable list. Geographic diversity matters: a network spread across many regions is more resilient to outages than one concentrated in a single location. Click any validator to open its [detail page](/docs/explorer/validator-details). --- # Validators Directory URL: /docs/explorer/validators > Browse every validator securing the X1 network — stake, commission, APR, vote performance, and status — and find the right one to delegate to. # 🛡️ Validators Directory The **Validators** page (`/validators`) is the complete directory of validators securing the X1 network. Use it to compare validators and pick one to stake with. ## What you'll see Each validator row shows the essentials at a glance: | Column | What it means | | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Name** | The validator's name (or a shortened address if unnamed). | | **Status** | **Active** validators are producing blocks and voting; **Delinquent** validators have stopped voting recently. | | **Stake** | Total XNT delegated to this validator. | | **Commission** | The percentage the validator keeps from staking rewards before paying delegators. | | **APR** | The estimated annual reward rate for delegators, based on recent on-chain rewards. | | **Vote Performance** | How reliably the validator is voting on blocks — higher is better. | | **Cumulative Stake** | This validator's stake plus every validator ranked above it, as a share of the whole network. It's a decentralization signal: the fewer validators it takes to reach 33%, the more concentrated the network. | ## Finding a validator * **Search** by name or address using the search box at the top. * **Filter** by status (active / inactive), commission range, and stake size. * **Sort** any column by clicking its header. By default the list shows **active validators only**. Toggle the filter to include inactive ones. ## Choosing a validator to stake with A few things worth comparing before you delegate: * **Commission** — lower commission means you keep more of your rewards. * **APR** — the estimated return after commission. * **Vote Performance** — consistent, high vote performance means the validator is reliable and earning full rewards. * **Status** — always choose an **Active** validator. * **Decentralization** — spreading stake to smaller validators helps keep the network healthy. Click any validator to open its [detailed page](/docs/explorer/validator-details), or head straight to [staking](/docs/explorer/staking) to delegate. --- # XNT Analytics URL: /docs/explorer/xnt-analytics > Read XNT tokenomics — supply, staked amount, burn, and inflation — on the X1 Explorer. # XNT analytics The **XNT Analytics** page (under **Analytics → XNT**) is your window into the tokenomics of X1's native token. ## What you'll see ## Reading the metrics * **Inflation** — the current rate at which new XNT is issued as staking rewards. * **Active Delegation** — the share of supply that's staked. A higher staked share generally means a more secured network. * **Progress to target** — how current figures track against the network's tokenomics targets. These numbers are pulled live from the chain, so the page always reflects the current state of XNT. Curious how much you could earn by staking? Head to the **[Staking](/docs/explorer/staking)** section to delegate XNT and track your per-epoch rewards. --- # FortiSwap URL: /docs/fortiswap > FortiSwap is the easiest way to start with crypto — sign in with an account you already have, get wallets created for you, and buy, swap, and move value on X1 (live mainnet) or Arc (Circle's chain, testnet preview) without learning the machinery underneath.
Sign in with an account you already have — email, Google, or a passkey — and swap, bridge, and buy crypto without touching a seed phrase, on X1 (live mainnet) or Arc (Circle's chain, testnet preview). See how it works, then read the API.} ctaHref="/docs/fortiswap/api" ctaLabel="Read the API reference" /> ## What FortiSwap is **FortiSwap** ([app.fortiblox.com](https://app.fortiblox.com)) exists to make the first minute of crypto feel like the first minute of any other web app. You sign in with an account you already have — an email address, Google, X, Discord, GitHub, Telegram, or a passkey — and FortiSwap creates the wallets you need and looks after them for you. Then you pick what you have, pick what you want, and confirm. Everything that makes crypto hard to start with — wallets, addresses, network fees, wrapping, bridging between chains, signing transactions — is handled behind the interface. You still own everything: the wallets created for you are yours, only you can use them, and you can take the keys with you to another wallet at any time. Start with [Why FortiSwap](/docs/fortiswap/benefits), then pick a network below. FortiSwap runs on two real networks, not one with an add-on: * **X1** is the established network — real money, live today. Buy and Sell with a card or bank, on-chain Orders, and cross-chain bridges to Solana and the major EVM chains all settle here. Start with [Using FortiSwap](/docs/fortiswap/how-to). * **Arc** is Circle's new chain, built around USDC as its own native currency — and the network FortiSwap opens to by default. Swap, bridge, and on-chain orders all work on Arc today, but only against Circle's **test network**: it moves test funds, not real money, and every part of it is marked TESTNET, ready for the day Arc's mainnet opens. There is no fiat ramp on Arc yet — Buy and Sell stay on X1 until Circle's own onramp lands. Start with [Using FortiSwap on Arc (testnet)](/docs/fortiswap/arc). Every swap carries FortiSwap's own **0.25% protocol fee**, collected on-chain in the same transaction as the swap — see [Fees](/docs/fortiswap/fees) for the full breakdown on both networks, including what a bridge or card leg adds.
--- # Agents — pay-per-call access URL: /docs/fortiswap/agents > How an automated agent pays for FortiSwap API calls over the open x402 protocol — reading the 402 challenge, signing and retrying, the replay rule, settlement receipts, accepted networks, and the machine-readable catalog. # Agents: pay-per-call access The priced FortiSwap endpoints — listed with their prices on [Developers and API](/docs/fortiswap/api#pay-per-call-x402) — can be called without an API key or an account. The caller pays a fraction of a cent in USDC per successful call using the open [x402](https://docs.x402.org) protocol, version 2. This page covers only what the API page does not: the payment handshake itself. Request and response shapes, error codes, and the protocol fee are all on the API page. The open-source reference client, [`github.com/fortiblox/x402-agent-kit`](https://github.com/fortiblox/x402-agent-kit), implements everything below and runs the full token → quote → build → sign → send flow. Use it as-is or read it alongside this page. ## How a paid call works 1. The agent makes a normal HTTP request to a priced endpoint. 2. The server answers `402 Payment Required`. The `PAYMENT-REQUIRED` response header carries a base64-encoded JSON document that states the price and where to pay it. 3. The agent signs a USDC payment authorisation for exactly that amount, locally, with its own key. 4. The agent repeats the same request with the signed authorisation in a `PAYMENT-SIGNATURE` header. 5. The server has the payment verified by the x402 facilitator it is configured with, runs the endpoint, and — only if the endpoint returned a 2xx — has the payment settled on-chain. The response carries a `PAYMENT-RESPONSE` header with the settlement receipt. Two consequences matter for an agent. **You are only charged for a successful response**: any 4xx or 5xx from the endpoint itself cancels the verified payment, and nothing moves on-chain. And **settlement is real and final**: the receipt names an on-chain transaction you can look up on that chain's explorer. ## Reading the 402 The body of a 402 is a short JSON error (`code: "PAYMENT_REQUIRED"`) that points you at the header. Decode the `PAYMENT-REQUIRED` header — this is the live shape from `POST /api/quote`, with the long descriptive fields trimmed: ```json { "x402Version": 2, "error": "Payment required", "resource": { "url": "https://app.fortiblox.com/api/quote", "description": "…", "mimeType": "application/json", "serviceName": "FortiSwap" }, "accepts": [ { "scheme": "exact", "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "amount": "1000", "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "payTo": "FdQ2FmAydXBe87Nm7w4MjksRqTUjahPaqjj7mVshKvNa", "maxTimeoutSeconds": 300, "extra": { "feePayer": "BENrLoUbndxoNMUS5JXApGMtNykLjFXXixMtpDwDR9SP" } }, { "scheme": "exact", "network": "eip155:8453", "amount": "1000", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x581aB190DF2B2932175d987E787Acd28A85eAA1C", "maxTimeoutSeconds": 300, "extra": { "name": "USD Coin", "version": "2" } } ], "extensions": { "payment-identifier": { "info": { "required": false } }, "…": "…" } } ``` | Field | Meaning | | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | `accepts[]` | The ways you may pay. Pick one entry and satisfy it exactly. | | `scheme` | Always `exact`: you authorise precisely `amount`, never more. | | `network` | The chain, as a CAIP-2 identifier. `solana:5eykt…` is Solana mainnet; `eip155:8453` is Base. | | `asset` | The token contract or mint to pay in — USDC on that chain. | | `amount` | The price in the asset's smallest unit. USDC has 6 decimals, so `"1000"` is $0.001. | | `payTo` | The receiving wallet. It is the same wallet that collects the FortiBlox protocol fee on that chain; if a 402 ever shows anything else, do not pay it. | | `maxTimeoutSeconds` | How long the authorisation you sign should remain valid. | | `extra.feePayer` | Solana only: the account that pays the Solana transaction fee, so your wallet needs USDC and nothing else. | | `extensions["payment-identifier"]` | Optional idempotency support — see [Retrying safely](#retrying-safely). | Prices per endpoint, and the schema and example body for each, are the same in the [catalog](#discovery) as in the 402. ## Signing and retrying Sign an authorisation that matches the chosen `accepts[]` entry field for field — scheme, network, asset, amount, and `payTo` — and repeat the request with the signed payload, base64-encoded, in a `PAYMENT-SIGNATURE` header. On Solana the payload is a partially signed transaction transferring `amount` of the asset to `payTo`, with `extra.feePayer` as fee payer; on Base it is a signed EIP-3009 transfer authorisation, so you need no ETH. The reference client and the standard x402 client libraries build both. Bound your spend in the client before signing: a per-payment cap (the highest FortiSwap price is $0.01), an asset allowlist of USDC only, and, if you want to hard-pin the receiver, a `payTo` policy set to the two addresses above. ## Retrying safely The rule is simple and worth stating plainly: **to retry, re-send the same signed payload. Never re-sign.** A signed authorisation is single-use on-chain, so re-sending the identical `PAYMENT-SIGNATURE` can never be charged twice. Signing a fresh one for the same logical operation can. To make retries clean, attach a `payment-identifier`: * Generate one id per logical operation — not per HTTP attempt — of 16 to 128 characters from `A-Z a-z 0-9 _ -`, and keep it until you have a response. Put it in `extensions["payment-identifier"].info.id` of the signed payload. * To retry, send the identical request: same method, path, query, body bytes, and the same `PAYMENT-SIGNATURE` value. Persist both if you need to survive a process restart. | Situation | Result | | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | | New id | Verified, executed, settled once; response cached for 15 minutes. | | Same id, identical request and identical signed payment, within 15 minutes | The cached response is replayed with no second charge and an `X-Idempotent-Replay: true` header. | | Same id while the first attempt is still in flight | The duplicate waits and receives the same replay. Exactly one settlement. | | Same id but anything differs — including a newly signed payment | `409 PAYMENT_ID_CONFLICT`. Not charged. Use a fresh id for a new operation. | | Same id, settled, but the response was too large (over 256 KB) to retain | `409 PAYMENT_ID_CONSUMED`. Charged once, for the original; use a new id. | | First attempt did not settle | The id is released and may be reused. | The idempotency store lives in memory on the serving instance with a 15-minute window; treat it as a safety net for retries, not a cache. ## The settlement receipt A `200` carries a `PAYMENT-RESPONSE` header, base64-encoded JSON: ```json { "success": true, "transaction": "", "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "payer": "" } ``` `transaction` is a real on-chain transfer from `payer` to `payTo`; look it up on the chain's explorer whenever you want to audit what you have spent. If verification passed but settlement failed, the call returns `402 SETTLEMENT_FAILED` with the same header carrying `success: false` and an `errorReason`, and the response body is withheld. ### Payment-layer status codes | Status | `code` | Meaning | What to do | | ------ | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 402 | `PAYMENT_REQUIRED` | No payment presented, or the header could not be decoded. | Read `PAYMENT-REQUIRED`, sign, retry. Not a charge. | | 402 | `PAYMENT_INVALID` | Rejected at verification; `message` says why (insufficient funds, wrong amount, expired or reused authorisation, mismatched `payTo`, no USDC token account, or a compliance decline). | Fix the cause and sign a new payment. Nothing settled. | | 402 | `SETTLEMENT_FAILED` | Endpoint ran, settlement failed. | Read `errorReason`; for a confirmation timeout or block-height error, confirm on-chain before paying again. | | 402 | `X402_V1_NOT_ACCEPTED` | Legacy `X-PAYMENT` header (protocol v1). | Use a v2 client. | | 409 | `PAYMENT_ID_CONFLICT` / `PAYMENT_ID_CONSUMED` | See [Retrying safely](#retrying-safely). | Not charged / charged once. | | 429 | `RATE_LIMITED` | 30 paid calls per minute per IP, 60 per paying wallet (`X-RateLimit-Scope` says which). | Back off for `Retry-After`. Refused before verification — nothing charged and the signed payment is unspent. | | 500 | `X402_HANDLER_ERROR` | The endpoint threw after verification. | The verified payment was cancelled. Safe to retry with a new payment. | | 502 | `X402_SETTLE_TIMEOUT` | Settlement timed out after 60 seconds; the outcome is indeterminate. | **Do not re-sign.** Check your wallet on-chain for a USDC transfer of `amount` to `payTo`. If in doubt, contact support with your `payment-identifier` and the timestamp — a settlement ledger keyed by payer and payment id exists for exactly this case. | Any other 4xx or 5xx is the endpoint's own response, documented on the [API page](/docs/fortiswap/api#conventions), and is never charged. ## Networks and assets Payment is accepted in **USDC on Solana mainnet** (Solana transaction fee sponsored — you need no SOL) and **USDC on Base** (you need no ETH). There is no facilitator on X1 today, so payments are not yet accepted in USDC.X; the swaps you build and sign still execute on X1 as usual. ## Discovery * [`/api/x402/discovery`](https://app.fortiblox.com/api/x402/discovery) — the machine-readable catalog: every priced endpoint with its `accepts[]`, a JSON schema for the request body, and a worked example. New paid routes appear here first; a client that reads the catalog needs no code change when one is added. * [`/llms.txt`](https://app.fortiblox.com/llms.txt) — a compact plain-text description of the same for language-model agents. ## What the server sees and keeps Your keys never leave your process. A `PAYMENT-SIGNATURE` authorises one specific amount, asset, receiver, and expiry; the server forwards it for verification and settlement and cannot alter it or spend anything else. Settled payments (payer, network, amount, resource, transaction, payment id) are recorded in a ledger for reconciliation and support. Responses to paid calls are cached for at most 15 minutes to serve replays; request bodies are not stored, only a hash for the idempotency check. ## Support [support@fortiblox.com](mailto:support@fortiblox.com) or the **Contact support** form in the app footer. Include the endpoint, the network, the `code` from the error body, your `payment-identifier` if you set one, and the `transaction` from `PAYMENT-RESPONSE` if you have one. --- # Developers and API URL: /docs/fortiswap/api > Quote, build, and inspect X1 swaps over HTTP — free with an API key at a published rate limit, or pay-per-call over x402 with no key at all. Real request and response examples, error shape, and fee notes. # Developers and API Everything the FortiSwap app does with a quote or a swap transaction is available as a plain HTTP API at: ``` https://app.fortiblox.com ``` A note on onboarding: the app's "sign in, no wallet needed" experience is a feature of the app, not of the API. The API is wallet-address-based — every transaction it builds is for a `payer` public key that your user already controls, and your integration is responsible for that wallet and for signing. The API does not create wallets or hold keys. One thing is true of every swap built through it, whoever is calling: the server never holds a key. It returns an unsigned, pre-simulated transaction, and the caller signs and broadcasts it. Fee note: every swap carries the 0.25 % protocol fee, already reflected in the quote's `amountOutNet` and the built transaction's `platformFee`, on both tiers below. ## Access tiers **How to get access** * **Free key.** Fill in the [request form](https://app.fortiblox.com/developers/request-key) with your project name, website, expected daily request volume, and the wallet you will pay swap fees from — or email the same details to [support@fortiblox.com](mailto:support@fortiblox.com). Keys are issued manually, usually within a business day, and shown once. * **Partner tier.** Higher limits are available by agreement. Same email; say what volume you need and how you plan to use it. * **Pay-per-call.** Needs no contact at all: point an x402 client at any priced URL and pay per request. | | Free key | Partner key | Pay-per-call | | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | ----------------------------------------------------------- | | **Auth** | `X-API-Key: fbfree_…` header | `X-API-Key: fbfree_…` header | None — x402 v2 payment per request | | **Cost** | No charge beyond the protocol fee on swaps | By agreement; no charge per request beyond the protocol fee on swaps | Per-call USDC price (below), plus the protocol fee on swaps | | **Limits** | **60 requests per minute** and **3,000 per day**, per key, shared across the endpoints it covers | **600 requests per minute** and **100,000 per day** by default; higher by agreement | Per-call | | **Endpoints** | `POST /api/quote`, `POST /api/tx/build` | `POST /api/quote`, `POST /api/tx/build` | All five priced endpoints | | **How to get it** | [Request form](https://app.fortiblox.com/developers/request-key) or email [support@fortiblox.com](mailto:support@fortiblox.com) (see above) | Email [support@fortiblox.com](mailto:support@fortiblox.com) after an agreement | Point an x402 client at any priced URL | `POST /api/tx/send` and `POST /api/tx/status` are free with no auth on either tier. ### API keys (free and partner) Send your key on every request. A missing or invalid key is not rejected with a 401 — the request simply falls through to the pay-per-call path and receives a `402`, so if you see `PAYMENT_REQUIRED` on a keyed call, check the header first. Every accepted response carries `X-RateLimit-Limit` and `X-RateLimit-Remaining` for the per-minute window and `X-RateLimit-Daily-Limit` / `X-RateLimit-Daily-Remaining` for the daily one. Exceeding either window returns `429`: ```json { "error": true, "message": "Rate limit reached for this key. Free keys allow 60 requests per minute and 3,000 per day; for higher limits contact support@fortiblox.com or use pay-per-call (see /docs/fortiswap/api).", "code": "RATE_LIMITED" } ``` with a `Retry-After` header in seconds. A partner key's message states that key's own limits. A key's tier and limits can be changed without re-issuing it, so an upgrade never requires you to rotate the key. ### Pay-per-call (x402) The priced endpoints speak the open [x402](https://docs.x402.org) protocol, version 2: request without payment, receive a `402` whose `PAYMENT-REQUIRED` header describes the price, sign a USDC payment, and retry. Payment is accepted in USDC on Solana mainnet or on Base. Prices as published in the live catalog: | Endpoint | Price per call | | ------------------------ | -------------- | | `POST /api/quote` | $0.001 | | `POST /api/tx/build` | $0.005 | | `GET /api/tokens` | $0.001 | | `GET /api/token/{mint}` | $0.001 | | `GET /api/router/volume` | $0.01 | The machine-readable catalog — prices, accepted networks, and a JSON schema and example for each endpoint — is served at [`/api/x402/discovery`](https://app.fortiblox.com/api/x402/discovery), and a compact text version for agents at [`/llms.txt`](https://app.fortiblox.com/llms.txt). Point an agent at either and it has everything it needs. The payment handshake itself — reading the 402, signing and retrying, the replay rule, and settlement receipts — is on [Agents: pay-per-call access](/docs/fortiswap/agents). ## Conventions * All amounts are **raw base units** as strings: `"1000000000"` is 1 XNT (9 decimals), `"1000000"` is 1 USDC.X (6 decimals). Read `decimals` from `/api/tokens` rather than assuming. * Native XNT is addressed by the wrapped mint `So11111111111111111111111111111111111111112`; wrapping and unwrapping are handled inside the built transaction. * Every error, on every endpoint, has the same shape: ```json { "error": true, "message": "inputMint and outputMint required", "code": "BAD_REQUEST" } ``` | Status | `code` | Meaning | | ------ | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | | 400 | `BAD_REQUEST` | Missing or malformed field; `message` says which | | 404 | `NO_ROUTE` | No route between the two mints for that amount | | 409 | `QUOTE_EXPIRED` | The quote's slot window has passed; re-quote | | 422 | `OUTPUT_TOO_SMALL` | Every route's output rounds below 1 raw unit of the output token at this size; `message` names the approximate minimum input when it can be derived | | 422 | `SIMULATION_FAILED` | The built transaction failed simulation; `details` carries the program logs and error | | 429 | `RATE_LIMITED` | Key window exceeded; honour `Retry-After` and read `message` for the key's limits | | 503 | `ROUTES_WARMING` | Route data is still loading after a restart; retry shortly | `POST /api/tx/build` can additionally return every code in [Build errors in detail](#build-errors-in-detail) below — it shares the routing engine with `/api/quote` but adds build- and simulation-specific failure modes. ## `POST /api/quote` Returns the best route for an exact input amount, with the alternatives it beat. **Request** ```json { "inputMint": "So11111111111111111111111111111111111111112", "outputMint": "B69chRzqzDCmdB5WYB8NRu5Yv5ZA95ABiZcdzCgGm9Tq", "amountIn": "1000000000", "slippageBps": 50 } ``` `slippageBps` is optional; without it the server picks a dynamic slippage for the pair and reports it. `maxHops` (1–4, default 4) caps route length. For a fixed output amount send `amountOut` with `"mode": "exactOut"` instead of `amountIn`. **Response** (trimmed — the live response also carries the full alternative and split analysis) ```json { "mode": "exactIn", "inputMint": "So11111111111111111111111111111111111111112", "outputMint": "B69chRzqzDCmdB5WYB8NRu5Yv5ZA95ABiZcdzCgGm9Tq", "amountIn": "1000000000", "amountOut": "384467", "amountOutNet": "383505", "minimumAmountOut": "383044", "slippageBps": 12, "slippageDynamic": true, "priceImpactPct": 0.00510352, "hops": 1, "highImpact": false, "thinLiquidity": false, "warnings": [], "route": [ { "venue": "xdex", "address": "CAJeVEoSm1QQZccnCqYu9cnNF7TTD2fcUA3E5HQoxRvR", "inMint": "So11111111111111111111111111111111111111112", "outMint": "B69chRzqzDCmdB5WYB8NRu5Yv5ZA95ABiZcdzCgGm9Tq", "feePpm": 2800, "priceImpactPct": 0.00510352, "amountIn": "1000000000", "amountOut": "384467" } ], "fee": { "bps": 25, "amount": "962", "pct": 0.25, "net": "383505", "enforcedOnChain": false }, "confidence": { "score": 100, "level": "high", "band": "excellent" }, "safety": { "level": "safe", "reasons": [] }, "asOfSlot": 75215315, "validUntilSlot": 75215360, "ttlMs": 17000, "expiresAt": 1788055353341 } ``` Field notes: * `amountOut` is the gross pool output; `amountOutNet` is after the 25 bps fee and is what the wallet receives; `minimumAmountOut` is the post-fee floor at the reported slippage. * `warnings[]` carries `HIGH_PRICE_IMPACT` and `THIN_LIQUIDITY` entries with human-readable messages — show them; the app does. * `route[]` is the chosen path hop by hop, with each pool's own fee as `feePpm`. `hops` and, where a route split is used, `split`/`splitAmountOut` describe the shape; show them alongside the price so users can see what they are getting. * `fee.enforcedOnChain` in a **quote** is a conservative preview; the authoritative flag is `feeEnforcedOnChain` on the **built transaction**, where the execution path is known. The amount is the same either way. * `validUntilSlot` / `ttlMs` bound the quote's life. Build promptly, or expect `QUOTE_EXPIRED` and re-quote. ### Exact-out quotes Send `amountOut` and `"mode": "exactOut"` instead of `amountIn` to ask "how much input do I need to receive exactly this much output?" — useful when the user is typing into the *receive* box, or when a downstream step needs an exact output amount. ```json { "inputMint": "So11111111111111111111111111111111111111112", "outputMint": "B69chRzqzDCmdB5WYB8NRu5Yv5ZA95ABiZcdzCgGm9Tq", "amountOut": "384467", "mode": "exactOut" } ``` The response carries the same fields as an exact-in quote, with `amountIn` as the computed input and `maxAmountIn` as the worst-case spend at the reported slippage — the figure to show as "you pay up to". `amountOut` in the response is the amount you asked for; `amountOutNet` is what you actually receive after the protocol fee. Exact-out is not available on every deployment: when the on-chain router is required for execution, exact-out is refused at build time with `EXACT_OUT_UNSUPPORTED_WITH_ROUTER` (see [Build errors in detail](#build-errors-in-detail)) because the router has no exact-out instruction — quote in exact-out for pricing, but be ready to fall back to exact-in for the build. ### Simulate before you quote Add `"simulate": true` and `"payer": ""` to have the server build and simulate the chosen route against the real chain before returning the quote, and fall through to the next-best alternative if the top-ranked route fails simulation. This costs an extra RPC round trip, so it is opt-in — use it when you want a quote you can be confident will actually build, for example immediately before showing a "Review" screen. ```json { "inputMint": "So11111111111111111111111111111111111111112", "outputMint": "B69chRzqzDCmdB5WYB8NRu5Yv5ZA95ABiZcdzCgGm9Tq", "amountIn": "1000000000", "simulate": true, "payer": "YOUR_WALLET_PUBLIC_KEY" } ``` The response adds two fields: `simulated` (the simulation result, or `null` if `simulate` wasn't set or no `payer` was given) and `executable` (`true`/`false` once a route has been simulated, `null` otherwise). If simulation promotes an alternative over the pathfinder's top pick, every field in the response — `route`, `amountOut`, slippage, impact, `explanation` — describes the route that actually simulated successfully, never the original best guess with `executable: true` bolted on. ## `POST /api/tx/build` Builds an unsigned X1 transaction for the route, simulates it, and returns it as base64. **Request** ```json { "inputMint": "So11111111111111111111111111111111111111112", "outputMint": "B69chRzqzDCmdB5WYB8NRu5Yv5ZA95ABiZcdzCgGm9Tq", "amountIn": "100000000", "payer": "YOUR_WALLET_PUBLIC_KEY", "slippageBps": 50, "priorityFeeMicroLamports": 1000 } ``` `payer` is the wallet that will sign; it must exist on X1 with enough XNT for the swap and fees, or simulation fails with `SIMULATION_FAILED` (`"AccountNotFound"`). Optional fields: `mode: "exactOut"` with `amountOut` instead of `amountIn` (see [Exact-out quotes](#exact-out-quotes) — not available on every deployment, see the error table below), `priorityFeeMicroLamports` (price per compute unit) or `priorityFeeLamports` (a total priority-fee budget), `maxHops`, `validUntilSlot` from a prior quote, `keepWrappedOutput: true` to receive WXNT instead of the automatic unwrap to native XNT on an XNT-output swap, and `acknowledgeHighImpact: true` to build a route the quote flagged as high impact. **Response** (trimmed) ```json { "transaction": "", "mode": "exactIn", "expectedOut": "38448", "minOut": "38159", "feeApplied": true, "feeAmount": "97", "platformFee": { "bps": 25, "percent": "0.25", "amountToken": "97" }, "feeEnforcedOnChain": true, "slippageBps": 50, "computeUnitLimit": 135000, "txSize": 623, "hopsUsed": 4, "safety": { "level": "safe", "reasons": [] }, "blockhash": "2CHhD97ULLfCp2cU8XPZjtKJKXhDRryxCzRqgdywDtfT", "lastValidBlockHeight": 74735924, "simulation": { "unitsConsumed": 88536 }, "route": { "split": false, "parts": [ { "legs": [ { "venue": "xdex", "address": "CAJeVEoSm1QQZccnCqYu9cnNF7TTD2fcUA3E5HQoxRvR", "amountIn": "100000000", "amountOut": "38448" } ] } ], "amountIn": "100000000", "amountOut": "38448", "priceImpactPct": 0.00051035 } } ``` Deserialize `transaction` as a versioned (v0) transaction, sign it with the payer's key, and broadcast it — either to X1 directly or through [`POST /api/tx/send`](#post-apitxsend), then poll [`POST /api/tx/status`](#post-apitxstatus). ### Build errors in detail `/api/tx/build` shares its routing engine with `/api/quote`, so it can return every code on the [conventions error table](#conventions) above, plus these build- and simulation-specific ones: | Status | `code` | Meaning | What to do | | ------ | ----------------------------------- | ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- | | 400 | `EXACT_OUT_UNSUPPORTED_WITH_ROUTER` | This deployment requires the on-chain router for execution, and the router has no exact-out instruction | Use `mode: "exactIn"` | | 400 | `INTEGRATOR_FEE_DISABLED` | `integratorFeeBps` / `integratorFeeRecipient` was sent but integrator fees aren't enabled on this deployment | Omit both fields, or contact support | | 422 | `TX_TOO_LARGE` | Every buildable route exceeds the network's transaction size limit | Reduce `maxHops`, or try a simpler pair | | 422 | `HIGH_PRICE_IMPACT` | The best buildable route exceeds the price-impact cap and `acknowledgeHighImpact` wasn't set | Re-quote for a smaller amount, or set `acknowledgeHighImpact: true` | | 422 | `IMPACT_CEILING` | Every buildable route exceeds the hard impact ceiling — refused even when acknowledged | Reduce the trade size; there is no override | | 422 | `ROUTER_INELIGIBLE` | This deployment requires the on-chain router and no candidate route can execute through it | Try a different pair or amount | | 422 | `INSUFFICIENT_FUNDS` | `payer` doesn't hold enough of the input token to cover this trade | Fund the wallet, or reduce the amount | | 422 | `INSUFFICIENT_GAS` | `payer` doesn't hold enough XNT for network fees and any new token accounts the route needs | Fund the wallet with a little XNT | | 422 | `ROUTER_FEE_MISMATCH` | An internal check on the simulated transaction's on-chain fee didn't match what was expected; nothing is returned | Retry — never a transaction you should sign | | 422 | `ROUTER_STALE_INSTRUCTION` | Your client is calling an on-chain router entrypoint that has since been retired by a program upgrade | Update or reload your client / SDK | | 503 | `ROUTER_PAUSED` | The on-chain router is paused | Wait and retry — nothing you can change client-side | | 503 | `GUARD_UNAVAILABLE` | A safety check the route needs couldn't be completed (usually an RPC hiccup) | Retry | | 500 | `LEG_CHAIN_VIOLATION` | An internal consistency check on the route's legs failed before anything was built | Retry; contact support if it persists | Every one of these is returned **before** a transaction reaches your wallet — none of them are things you sign and then discover are wrong. ## Earn on the swaps you route An app that builds swaps through the API can take a fee of its own on each one. Add two fields to `POST /api/tx/build`: * `integratorFeeBps` — an integer from 1 to 300 (0.01 % to 3 %). * `integratorFeeRecipient` — the wallet address that receives the fee. Send both or neither. The fee is taken from the swap's output in the same transaction as the swap, on top of FortiSwap's 0.25 %, and delivered to the recipient's token account for the output token. It works on both tiers, and a request without these fields behaves exactly as before. **Request** ```json { "inputMint": "So11111111111111111111111111111111111111112", "outputMint": "B69chRzqzDCmdB5WYB8NRu5Yv5ZA95ABiZcdzCgGm9Tq", "amountIn": "100000000", "payer": "YOUR_WALLET_PUBLIC_KEY", "integratorFeeBps": 100, "integratorFeeRecipient": "YOUR_FEE_WALLET" } ``` **Response** (trimmed) ```json { "transaction": "…", "expectedOut": "37090", "minOut": "36586", "feeApplied": true, "feeAmount": "93", "platformFee": { "bps": 25, "percent": "0.25", "amountToken": "93" }, "integratorFee": { "bps": 100, "percent": "1", "amountToken": "370", "recipient": "YOUR_FEE_WALLET" }, "feeEnforcedOnChain": true, "hopsUsed": 4 } ``` `integratorFee` reports what your app earns on this swap; `feeAmount` and `platformFee` remain FortiSwap's own fee only. The recipient must already hold a token account for the output token — the build never creates one. If it is missing, the build fails with `422 INTEGRATOR_FEE_DESTINATION_MISSING`, and the message names the exact account to create: ```text integrator fee destination for mint does not exist — create the associated token account for first ``` The response also carries `integratorFeeDestination`, `outputMint`, and `tokenProgram` as separate fields. If the account check itself cannot run, the build returns `503 INTEGRATOR_FEE_DESTINATION_UNVERIFIED`; retry. An `integratorFeeBps` outside 1–300, or either field without the other, is `400 BAD_REQUEST`. ### MEV protection via the API The app's MEV-protection toggle is not a private relay; X1 has no public mempool, and every swap reverts on-chain if it fills worse than its slippage. What the toggle does is cap effective slippage at 5 % so a sandwich has little room to profit. An integrator reproduces it by sending a tight `slippageBps` (500 or lower; the app's auto value is a good ceiling, and the quote's dynamic value is often far tighter) and a priority-fee budget (`priorityFeeLamports`, or `priorityFeeMicroLamports` per compute unit) so the transaction lands promptly inside its quote window. There is no separate flag to set. ## `POST /api/tx/send` Broadcasts an already-signed transaction to X1. Free, with no API key, on both tiers — this route never touches a key and never builds anything; it exists for a wallet whose injected provider only implements `signTransaction` (not `signAndSendTransaction`), so your client signs locally and hands the signed bytes here instead of talking to an RPC endpoint itself. **Request** ```json { "transaction": "" } ``` **Response** ```json { "signature": "5j7s…s1Kz" } ``` | Status | `code` | Meaning | | ------ | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | | 400 | `BAD_REQUEST` | `transaction` is missing, not a string, or not plausible base64/size for a signed transaction | | 400 | `UNSIGNED_TX` | The bytes decode to a transaction, but it carries no signature | | 429 | `RATE_LIMITED` | This route has its own limits, separate from your API key's: **30 requests per minute per caller** and **20 per minute per signing wallet** | | 502 | `SEND_FAILED` | The signed transaction could not be broadcast to X1; `message` carries the underlying reason | This route only ever relays a transaction you already have a valid signature for — it never signs, never modifies, and never holds a key of its own. ## `POST /api/tx/status` Looks up the confirmation status of one or more transaction signatures — poll this after `POST /api/tx/send` (or after broadcasting yourself) to know when a swap has landed. Free, with no API key, on both tiers. **Request** ```json { "signatures": ["5j7s…s1Kz"] } ``` `signatures` takes 1 to 10 signature strings per call. **Response** ```json { "statuses": [ { "slot": 75215320, "confirmations": null, "err": null, "confirmationStatus": "finalized" } ] } ``` `statuses` is positional — one entry per signature you sent, in the same order, `null` where X1 has no record of that signature (not yet landed, or too old to still be indexed). `confirmationStatus` is `"processed"`, `"confirmed"`, or `"finalized"`; `err` is `null` for a successful transaction or the on-chain error otherwise. `confirmations` is `null` once a transaction reaches `"finalized"`. | Status | `code` | Meaning | | ------ | ------------- | -------------------------------------------------------------------------------------------------------------------- | | 400 | `BAD_REQUEST` | `signatures` is missing, empty, has more than 10 entries, or contains something that isn't a signature-shaped string | | 502 | `RPC_ERROR` | The status lookup itself failed; retry | ## `GET /api/tokens` Every token FortiSwap routes on X1, with price and market data. Call it first to resolve a symbol to a mint. ```json { "updatedAt": 1788055263960, "refreshing": false, "warming": false, "tokens": [ { "mint": "So11111111111111111111111111111111111111112", "symbol": "XNT", "name": "XNT", "decimals": 9, "priceUsd": 0.3856, "logoURI": "https://app.xdex.xyz/assets/images/tokens/x1.webp", "sources": ["xdex"], "volume24hUsd": 10947.11, "fdvUsd": 412532004.52, "marketCapUsd": 5372658.76, "change1h": 0, "change1d": -1.47, "sparkline": [ "…" ], "trust": "verified" } ], "errors": [] } ``` `trust` is one of `verified`, `community`, `new`, `caution`, `danger`. The live list held 192 tokens at the time of writing. ## `GET /api/token/{mint}` Detail for one mint: price, 24-hour change, market cap and FDV, TVL, 52-week range, project links, and the pools it trades in. ``` GET /api/token/B69chRzqzDCmdB5WYB8NRu5Yv5ZA95ABiZcdzCgGm9Tq ``` ```json { "mint": "B69chRzqzDCmdB5WYB8NRu5Yv5ZA95ABiZcdzCgGm9Tq", "listed": true, "symbol": "USDC.X", "name": "USDC.X", "decimals": 6, "priceUsd": 1, "change24hPct": -0.67, "trust": "verified", "stats": { "tvlUsd": 16040.12, "marketCapUsd": 59823.14, "fdvUsd": 59823.14, "volume24hUsd": 3295.49, "high52wUsd": 1.2913, "low52wUsd": 0.1557 }, "about": { "description": null, "website": null, "twitter": null, "telegram": null }, "pools": [ { "address": "CAJeVEoSm1QQZccnCqYu9cnNF7TTD2fcUA3E5HQoxRvR", "tokenA": "WXNT", "tokenB": "USDC.X", "tvl": 15109.84, "apr24h": 22.01, "vol24h": 3292.21 } ], "updatedAt": 1788055263960 } ``` An address that is not a valid mint returns `400 BAD_REQUEST` with `"invalid mint"`. ## Volume statistics Daily FortiSwap trading volume on X1, from FortiBlox's own indexer of on-chain events. `?days=` takes 1–365 (default 90). Responses are cached for 60 seconds. ```json { "ok": true, "days": 90, "from": "2026-06-02", "to": "2026-08-30", "buckets": [ { "date": "2026-08-29", "txCount": 1, "volumeUsd": 12.85, "feeUsd": 0.0321, "uniqueUsers": 1, "pricedShare": 1 }, { "date": "2026-08-30", "txCount": 2, "volumeUsd": 1.52, "feeUsd": 0.0038, "uniqueUsers": 1, "pricedShare": 1 } ], "totals": { "txCount": 87, "volumeUsd": 679.65, "feeUsd": 1.6991, "pricedShare": 1 }, "updatedAt": 1788055287216 } ``` `feeUsd` is the protocol fee observed on-chain for that day's swaps; `pricedShare` is the fraction of the day's swaps for which a USD price was available. ## Support Questions and integration help: [support@fortiblox.com](mailto:support@fortiblox.com) or the **Contact support** form in the app footer. Key requests: the [request form](https://app.fortiblox.com/developers/request-key). --- # Using FortiSwap on Arc (testnet) URL: /docs/fortiswap/arc > The Arc walkthrough — sign in, get free testnet USDC from Circle's faucet, swap, and bridge — with plain-language explanations of what just happened at each step. Then the deeper reference — how the bridge stays safe, choosing how a swap settles, pools, and orders on Arc. # Using FortiSwap on Arc (testnet) The app at [app.fortiblox.com](https://app.fortiblox.com) opens on the **Arc** tab by default. **Arc** is a new blockchain built by Circle, the company behind USDC — and on Arc, USDC *is* the network's own currency, so the same token you hold also pays the small network fee, with no separate gas coin to keep topped up. Swap, Bridge, and on-chain Orders all work on Arc today. Everything in this walkthrough runs on Arc's **test network**. It moves **test funds, not real money**, and every part of it is marked **TESTNET**. It is here so the flow is ready and proven the day Arc's main network opens — until then, nothing you do here has real-world value. If you want the walkthrough for real money today, X1 is FortiSwap's established network — see [Using FortiSwap](/docs/fortiswap/how-to). ## Your first minute on Arc ### Sign in Press **Connect** in the top-right corner and choose **Email or social login**. Sign in with your email address, Google, X, Discord, GitHub, Telegram, or a passkey. **What just happened.** FortiSwap created a wallet for you that works on any EVM network, including Arc — the same wallet you would use on Ethereum or Base. There is nothing to download and nothing to write down, and the key is split across secure hardware so that only you can use it. Sign in again from any device and it is there. ### Get testnet USDC Arc has no fiat on-ramp yet, so you cannot buy USDC with a card here — instead, get it for free. Open [faucet.circle.com](https://faucet.circle.com), Circle's own testnet faucet, select **Arc Testnet**, and paste your wallet address (open your wallet from the top-right corner in FortiSwap to copy it). The faucet sends a small amount of test USDC directly to your wallet — nothing to buy, nothing to bridge in. **What just happened.** That same balance now covers everything you do next: because USDC is Arc's own gas token, the test USDC you received pays both the amount you swap or bridge *and* the small network fee, with no second token to request separately. ### Swap Open the **Swap** tab with Arc selected. Pick the token you are paying with and the token you want — for example USDC for EURC, Circle's euro-pegged token — and enter an amount. Choose **Switch wallet to Arc** if prompted (a one-time step that adds Arc to your wallet), then press **Swap** and approve. **What just happened.** FortiSwap can settle an Arc swap through more than one venue and picks the best-priced one for you by default — see [Choosing how a swap settles](#choosing-how-a-swap-settles) below. The swapped token arrives in the same wallet, and the step shows a link to Arc's own block explorer so you can follow it yourself. ### Bridge (optional) Open the **Bridge** tab, enter an amount of test USDC, and pick a destination test network — Base, Arbitrum, or Optimism Sepolia. Switch your wallet to Arc if you have not already, then press **Bridge** and approve. **What just happened.** Your USDC is burned on Arc, Circle attests to it, and the same amount is minted for you on the destination — each leg shown with its own explorer link. This is FortiBlox's own step-by-step implementation of Circle's cross-chain transfer protocol (CCTP), built so a transfer can never be stranded partway through — see [How the bridge stays safe](#how-the-bridge-stays-safe) below. ### Done Your new balance shows in the card and in your wallet. Every swap or transfer you make on Arc is visible on [ArcScan](https://testnet.arcscan.app), Arc's own testnet explorer, with your wallet as the signer. Arc also has real on-chain limit orders under the same **Orders** tab used on X1 — see [Orders on Arc](#orders-on-arc) below. ## How the bridge stays safe The Arc bridge is FortiBlox's own implementation of CCTP, built step by step rather than as one all-in-one call — Circle's own attestation leg can take a few minutes, and a single monolithic transfer had no way to recover if you closed the tab or reloaded during that wait. Each leg (burn, attestation, mint) is tracked and saved on its own, so if anything interrupts the transfer after your USDC is burned, it shows up as an unfinished transfer you can resume — your funds are never stranded, only waiting for the last step. Minting on the destination network also needs a small amount of that network's own gas token. FortiSwap checks your destination balance for you and, if you are short, tops it up automatically from a testnet faucet before asking your wallet to sign the mint — in most cases you will not need to think about destination gas at all. If the auto top-up is not available (the faucet is rate-limited, or the destination network is not one it supports), the app tells you plainly and links you to a public faucet instead; your burned USDC is already saved and waiting, and a **Complete mint** button finishes the transfer as soon as you are funded. ## Choosing how a swap settles A swap on Arc can be filled through more than one venue: FortiBlox's own on-chain **Aggregator route**, **Circle App Kit** (Circle's own swap contract), or **Circle StableFX** as it becomes available. By default FortiSwap picks whichever venue gets you the best price (**Auto**), but you can choose a specific venue instead — in Settings, or from the review screen before you confirm — and see how it compares to the alternatives before you sign. ## A note on network fees Arc's test network can have **large, fast-moving fees** — this is normal for a young network and does not happen on established chains. FortiSwap sets a fee with enough headroom to get your transaction through, but it means a transfer can reserve more test USDC up front than it finally spends. Keep a comfortable balance of test USDC beyond the amount you are moving — get more any time from [faucet.circle.com](https://faucet.circle.com) — and a transfer will not stall. ## Pools on Arc Arc pool pages show who is providing liquidity: a pool page lists LP holders for a standard (V2-style) pool, or the open concentrated-liquidity positions for a V3-style pool — never both, since each pool is only ever one kind. This data comes from an Arc indexer that is still backfilling history, so it is honest about being incomplete while that catches up: a holders table under active backfill says so and shows holders as of the block it has indexed so far, and the positions table carries the same caveat that more positions may appear as indexing continues. ## Orders on Arc Arc also has on-chain limit orders, filled by an off-chain keeper against a limit-order contract on Arc — the same **Orders** tab used for X1, with Arc selectable as the network, and the same order types described in [Orders](/docs/fortiswap/how-to#orders). This is real, end-to-end order execution, not a placeholder — like the rest of the Arc tab, it is testnet-only, so nothing filled here is real money. ## What changes at mainnet launch When Arc's main network goes live, this tab moves from test funds to real USDC on real Arc — the same modes, the same flow, with the **TESTNET** marking removed. Nothing about how you use it changes. --- # Why FortiSwap URL: /docs/fortiswap/benefits > Start in a minute with an account you already have and wallets created for you; keep full ownership; get best execution with the route in plain sight, warnings before you confirm, and card, bank, and cross-chain access — on X1's live mainnet or Arc's testnet preview. # Why FortiSwap FortiSwap runs on two networks: **X1**, its established network where real money moves today, and **Arc**, Circle's new chain — the network the app opens to by default, but currently a **testnet preview** only. Everything below applies to both unless it says otherwise. ## Start in a minute, with an account you already have Most crypto apps begin with homework: install a wallet, write down a recovery phrase, learn what a network is, work out how to get funds in. FortiSwap begins with a sign-in button. Use your email address, Google, X, Discord, GitHub, Telegram, or a passkey, and you are in. The wallets you need are created for you at that moment — one for X1 (which also works on Solana) and one for EVM chains, which is the same wallet Arc uses — and FortiSwap looks after them so you never have to think about them. There is nothing to install and nothing to write down. Signing in again from another device brings the same wallets back. When you are ready for more, you can add another wallet, import one you already have, or export your keys and move to any wallet you like. Starting easy does not lock you in. ## You own it, and you can prove it The wallets created for you are yours in the strict sense. Your key is split across secure hardware so that only you can use it; FortiSwap cannot spend from it, and neither can anyone at FortiBlox. Every purchase, swap, and transfer goes straight from your wallet to the network and is visible on a public explorer with your wallet as the signer. There is no FortiSwap balance to withdraw from, because FortiSwap never holds a balance for you. ## The chain stays in the back end Under a swap there is a stack of detail — wrapping the native token, opening token accounts, keeping enough of the network's fee token on hand, choosing pools, setting a slippage floor, signing and broadcasting. On X1 that fee token is XNT; on Arc, USDC itself pays the fee, so there is nothing separate to keep topped up. FortiSwap does all of it either way. What you see is a card with two boxes: what you pay and what you receive. What you do is confirm. When a detail matters to you it is there — the review screen shows the route, the guaranteed minimum, and the full cost — but nothing asks you to understand it before you can proceed. ## Best execution, with the route in plain sight On X1, liquidity is spread across pools, and the best price for a given size is rarely the obvious direct pair. FortiSwap quotes every viable route for your exact amount — direct, multi-hop, and split across pools — and picks the one with the highest **net** output after every fee, including its own. The quote you see is the amount you receive; there is no separate fee line to subtract afterwards. The route is never a black box. The review screen shows which venues the swap touches, how many hops it takes, whether it was split and in what proportion, and how much the chosen route saved against a plain direct swap. The same information is returned field-for-field through the [API](/docs/fortiswap/api), so an integrator can show its users exactly what the app shows. Arc's swap works differently, because Arc's liquidity is shaped differently: a swap there can settle through more than one **venue** — FortiBlox's own on-chain aggregator, Circle App Kit, or Circle StableFX — and FortiSwap picks the best-priced one by default, or lets you choose. See [Choosing how a swap settles](/docs/fortiswap/arc#choosing-how-a-swap-settles) on the Arc walkthrough. ## Warnings before you confirm, not after FortiSwap treats a risky trade as something to surface, not something to quietly execute. * **Price-impact grading.** Every quote carries its price impact — how much your own trade moves the price. Above 5 % you get a notice; between 10 % and 20 % you must tick an acknowledgement before the review screen opens; at 20 % and above the swap is disabled unless you deliberately enable Expert mode. Above the 25 % safety cap no route is offered at all. * **Thin-liquidity warnings.** When a pool is too shallow for your size, the card says so and suggests a slippage sized to the pool, instead of letting the trade fail or fill badly. * **Quote freshness.** Quotes refresh every 10 seconds with a visible countdown, and each one carries an expiry on-chain. A stale quote is never submitted. * **Slippage that is a floor, not a fee.** Auto slippage is 5 %; you can set anything from 0.01 % to 50 %. The minimum-received figure on the review screen is the guaranteed floor — the swap reverts on-chain if it would fill below it. * **MEV protection.** On by default. It caps your effective slippage at 5 % regardless of a higher custom setting, so a front-running bot has little room to profit. It does not claim to rule out all MEV. * **Token trust tiers.** Every listed token carries a tier — Verified, Community, New, Caution, or Danger — derived from on-chain signals, shown in the picker and in the token data endpoint. ## Buy and sell with a card or bank account In supported regions the Buy and Sell tabs let you purchase USDC with a debit or credit card or a bank transfer, delivered to your own wallet, and sell it back for a bank payout. FortiSwap compares the available payment options live and ranks them by how much you actually receive. Identity checks and payment processing are done by the regulated payment partner you choose; FortiSwap never sees your card details. This is **X1-only** for now — Arc has no fiat ramp yet, so Buy and Sell point you back to X1 when Arc is selected. ## In and out of X1 — or between Arc and its own test networks The Bridge tab brings USDC onto X1 from Solana and from the major EVM chains, and takes it back out. Routes are quoted with their full cost up front — the bridge's own fee is a line in the quote, not a surprise on arrival — and the destination address is fixed inside the transaction you confirm. Arc has its own bridge, to a different set of destinations: it moves test USDC between Arc and Base, Arbitrum, or Optimism Sepolia using Circle's CCTP, built step by step so a transfer is never stranded mid-way. See [Using FortiSwap on Arc (testnet)](/docs/fortiswap/arc). ## Orders that live on-chain Limit, stop-loss, take-profit, bracket (OCO), recurring (DCA and TWAP), trailing stop, and ladder orders all rest **on-chain**, on X1 or on Arc. There is no server-side watcher that dies when your tab closes and no custody handoff: an order can only ever fill at your minimum or better, or it reverts, and you can cancel it whenever you like. On Arc this is real, end-to-end order execution — just against test funds, like the rest of the Arc tab. ## One API, two ways to pay Everything the app does with a quote or a transaction on X1 is available over HTTP — free with an API key at a published rate limit, or per-call with no key at all over the open x402 payment protocol. Both tiers build the same transactions the app does, with the same fee. See [Developers and API](/docs/fortiswap/api). --- # Common questions URL: /docs/fortiswap/faq > Everything a FortiSwap user or integrator asks — signing in and wallets, fees, swapping and slippage, bridging, orders, buying and selling with a card or bank, the Arc testnet preview, and the API. # Common questions ## The basics FortiSwap ([app.fortiblox.com](https://app.fortiblox.com)) is a swap, bridge, and on/off-ramp app that runs on two networks: **X1**, a Solana-compatible chain, and **Arc**, Circle's new chain. You sign in with an account you already have, get wallets created for you automatically, and swap, bridge, and buy or sell crypto without installing anything or writing down a recovery phrase. See [Why FortiSwap](/docs/fortiswap/benefits). No. [Using FortiSwap](/docs/fortiswap/how-to) walks through the first minute on X1 — sign in, add funds, swap — with a plain-language explanation of what happens at each step, and [Using FortiSwap on Arc (testnet)](/docs/fortiswap/arc) does the same for Arc. Terms you might not know, like wallet, token, or slippage, are each defined in one line on [Words you'll see](/docs/fortiswap/glossary). Both are real networks with real functionality — swap, bridge, and on-chain orders all work on each — but they are not at the same stage. **X1** is established and live: real money moves through Swap, Bridge, Orders, Buy, and Sell today. **Arc** is Circle's new chain, built around USDC as its own gas token, and it's the network FortiSwap opens to by default — but only Circle's **test network** is live so far, so everything on Arc moves test funds, not real money, and is marked TESTNET. Arc also has no fiat ramp yet, so Buy and Sell stay on X1. See [Arc (testnet)](/docs/fortiswap/arc). Opening the app, signing in, and getting wallets costs nothing. Swapping carries FortiSwap's own 0.25% protocol fee, on top of the network's own small fee and, on a bridge or card leg, that provider's fee — see [Fees](/docs/fortiswap/fees) for the complete breakdown. Every fee is shown in the quote before you confirm; nothing is deducted afterward. ## Signing in & wallets Press **Connect** and choose **Email or social login** — email, Google, X, Discord, GitHub, Telegram, or a passkey. FortiSwap creates a wallet for X1 (which also works on Solana) and one for EVM chains the moment you sign in. Sign in again from any device and the same wallets are there. You do. The key is split across secure hardware so that only you can use it — not FortiSwap, not FortiBlox. You can export the private key at any time and move to any other wallet app; starting easy doesn't lock you in. See [Security and trust](/docs/fortiswap/security). Yes. Press **Connect** and pick it from the list — installed wallets show as **Detected**. FortiSwap builds each transaction and your wallet signs it in its own window; nothing happens until you approve there. You can also mix the two: sign in for the wallets FortiSwap creates and connect an external wallet alongside them. See [Bring your own wallet](/docs/fortiswap/how-to#bring-your-own-wallet). No. FortiSwap is non-custodial: every swap, order, and bridge transaction goes straight from your wallet to the network, and it's visible on a public explorer with your wallet as the signer. There is no FortiSwap-controlled account in the path of your funds — see [Security and trust](/docs/fortiswap/security). Sign in again from any other device with the same email, social account, or passkey, and your wallets come back — the key material is recoverable through your sign-in method, not stored only on one device. If you connected an external wallet instead, recovering it follows that wallet's own process; FortiSwap never held its key to begin with. ## Fees A flat **0.25% (25 basis points)** of the output amount, collected on-chain in the same transaction as the swap. The quote already reflects it — `amountOutNet` is what actually reaches your wallet, and the minimum-received figure is computed after the fee. See [Fees](/docs/fortiswap/fees). Yes, but none of them go to FortiSwap. Each pool a route passes through charges its own swap fee (shown per hop as `feePpm` in the API), and every transaction pays a small network fee — XNT on X1, or test USDC directly on the Arc testnet preview. A bridge or card leg itemises its own provider fee in the quote. Whatever the leg, any fee that goes to FortiBlox is a visible row before you sign, never a deduction after. No — orders carry the same 0.25% platform fee as a regular swap, shown on the order's review screen, and nothing else. Yes. An integrator can add up to 3% (300 basis points) of its own on top of FortiSwap's 0.25%, shown as its own `integratorFee` line in the build response — never folded into FortiSwap's fee. See [Earn on the swaps you route](/docs/fortiswap/api#earn-on-the-swaps-you-route). ## Swapping & slippage It searches every pool on X1 where your two tokens (directly or through intermediate hops) trade, including splitting a single swap across more than one route when that nets out ahead, and picks whichever gets you the highest **net** output after every fee, including its own. The review screen shows the venues, hop count, and any split so the route is never a black box. Slippage is the gap between the price you were quoted and the price you actually get if the market moves before your trade lands. It's a **floor**, not a fee: if the fill would come in worse than your slippage setting, the swap reverts on-chain instead of filling badly. The default is Auto (about 5%), and you can set anything from 0.01% to 50% in Settings; the card suggests a pair-specific value on thin pools rather than making you guess. Price impact is how much your own trade moves the price — small in a deep pool, large in a shallow one. FortiSwap notices above 5%, makes you tick an acknowledgement between 10% and 20%, and disables the swap at 20% and above unless you turn on Expert mode; above a 25% hard cap, no route is offered at all regardless of settings. X1 has no public mempool, so this isn't a private relay — it caps your **effective slippage at 5%**, even if you've set a higher custom value, so a front-running bot has little room to profit from a sandwich. It's on by default and it's a cap, not a claim that no MEV exists at all. See [MEV protection via the API](/docs/fortiswap/api#mev-protection-via-the-api) for how an integrator reproduces it. Quotes refresh automatically every 10 seconds in the app and carry a short on-chain expiry window (`validUntilSlot` / `ttlMs` in the API) so a stale quote is never submitted. If you wait too long between quoting and confirming, just quote again — it costs nothing. Verified, Community, New, Caution, or Danger — derived from on-chain signals about a token, shown in the token picker and in the token API. Treat it as a starting point for your own research, not a verdict; see [Words you'll see](/docs/fortiswap/glossary) for the one-line definition. ## Bridging Into X1 from Solana or from Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Chain, Avalanche, Linea, Cronos, HyperEVM, Story, Monad, or Sui; out of X1 to Solana or to those EVM chains. The picker only offers destinations that a source chain can actually reach end to end. TRON is reachable only as a destination from a Solana source, never from X1 directly. See [Bridge in and out](/docs/fortiswap/how-to#bridge-in-and-out). No. Each corridor is operated by its own independent bridge; FortiSwap quotes the transfer, including that bridge's own fee and estimated time, up front as line items — see [Security and trust](/docs/fortiswap/security#what-fortiswap-does-not-do). A flat **1 USDC** fee and no FortiBlox fee on top, with a transfer window from an **11 USDC minimum** (10 delivered plus the flat fee) up to **5,000 USDC**, reduced when less liquidity is available. A route from an EVM source instead carries a FortiBlox fee of up to 0.25%, already included in the guaranteed minimum. See [Fees](/docs/fortiswap/fees#bridge-and-fiat-legs). A bridge transfer is tracked until it lands, and its progress — including any provider-side delay — is shown in the card. If something about a specific transfer looks stuck, contact [support@fortiblox.com](mailto:support@fortiblox.com) with the transaction signature. ## Orders Limit, stop-loss, take-profit, OCO (one-cancels-the-other), recurring (DCA or TWAP), trailing stop loss, and ladder — each explained with what it does and when to use it on [Orders](/docs/fortiswap/how-to#orders). Yes. Every order type rests on-chain from the moment you place it — there is no off-chain watcher tied to your browser tab or session. An order fills only at your minimum or better, or it reverts; you can cancel it at any time from the Orders page. Both spend or sell on a repeating schedule. **Standard** (DCA) splits your total into equal-sized purchases across the schedule — classic dollar-cost averaging. **TWAP** uses the same schedule but slices execution to target reduced price impact per fill rather than a strictly even split. Both accept an optional USD price band that skips a cycle if the market is outside it. You set a trail distance as a percentage instead of a fixed price. The trigger sits that distance below the market and moves up on-chain as the price makes new highs, then fills once the price retraces back down through it — so it locks in more of a rally the longer you let it run, without resetting a stop by hand. A Ladder is one on-chain order covering up to eight ascending price rungs, each a portion of your total position. Every rung fills independently once its price is reached, and any unfilled rung can still be cancelled on its own — it scales you out across several targets without you managing several separate orders. ## Buying & selling Open the **Buy** tab, enter an amount, and pick a payment method — in supported regions, a debit or credit card or a bank transfer. FortiSwap compares the options available in your country side by side, ranked by how much you actually receive, and delivers the funds to your own wallet, not an account FortiSwap holds. See [Add funds](/docs/fortiswap/how-to#add-funds). No. Identity verification and payment processing are handled entirely by the regulated payment partner you choose; FortiSwap never receives your card details and adds no fee of its own to a card purchase or bank payout. See [Security and trust](/docs/fortiswap/security#what-fortiswap-does-not-do). Yes, in supported regions — the **Sell** tab turns USDC into a bank payout. Availability, payment methods, and limits vary by country and are set by the payment partner, shown live in the card. ## Arc (testnet preview) Arc is a testnet-only preview of bridging and swapping USDC on Circle's new Arc network — it moves test funds, not real money, and is marked TESTNET everywhere it appears. It exists so the flow is proven ahead of Arc's mainnet launch. See [Arc (testnet)](/docs/fortiswap/arc). On Arc, USDC is the network's own currency — the same token you hold also pays the small network fee, so there's no separate gas token to keep topped up, unlike XNT on X1. The same two modes and the same flow move from test funds to real USDC on real Arc, with the TESTNET marking removed. Nothing about how you use it changes. See [What changes at mainnet launch](/docs/fortiswap/arc#what-changes-at-mainnet-launch). ## Developers & agents Yes — everything the app does with a quote or a swap transaction is available over plain HTTP, free with an API key at a published rate limit, or pay-per-call with no key at all over the open x402 protocol. See [Developers and API](/docs/fortiswap/api). Fill in the [request form](https://app.fortiblox.com/developers/request-key) or email [support@fortiblox.com](mailto:support@fortiblox.com) with your project, expected volume, and the wallet you'll pay swap fees from. Free keys are issued by hand, usually within a business day. Higher, partner-tier limits are available by agreement. Yes. The priced endpoints accept payment per call over x402, version 2 — no key, no sign-up. An agent reads a `402` challenge, signs a small USDC payment, and retries; only a successful response is charged. See [Agents: pay-per-call access](/docs/fortiswap/agents). They show up first in the machine-readable catalog at [`/api/x402/discovery`](https://app.fortiblox.com/api/x402/discovery) (and the compact [`/llms.txt`](https://app.fortiblox.com/llms.txt) for language-model agents) — a client that reads the catalog needs no code change when a new priced route is added. Yes. Add `integratorFeeBps` (1 to 300, i.e. 0.01% to 3%) and `integratorFeeRecipient` to `POST /api/tx/build`; the fee is taken from the swap's output in the same transaction, on top of FortiSwap's own 0.25%, and paid directly to your recipient's token account. See [Earn on the swaps you route](/docs/fortiswap/api#earn-on-the-swaps-you-route). ## Questions Questions: [support@fortiblox.com](mailto:support@fortiblox.com) or the **Contact support** form in the app footer. --- # Fees URL: /docs/fortiswap/fees > The 0.25% protocol fee, pool fees, the network fee, and what bridge and fiat legs add. # Fees FortiSwap has one fee of its own and no hidden ones. Everything else you pay goes to the pool, the network, or — on a bridge or fiat leg — the provider that performs it, and each is shown in the quote before you sign. ## The protocol fee: 0.25 % Every swap pays **0.25 % (25 basis points)** of the output amount to FortiBlox. The quote already reflects it: `amountOut` is the gross pool output, `amountOutNet` is what reaches your wallet, and the minimum-received figure is computed after the fee. The fee is collected on-chain by FortiSwap's program at `3geAsZiNaWDuTVtTbdWVQRitd55jY4UoWeeBmJFTJZmE`, in the same transaction as the swap, and it is the same whether you use the app or the [API](/docs/fortiswap/api). Orders carry the same 0.25 % platform fee, shown on the order review screen. An app that integrates the [API](/docs/fortiswap/api) may add a fee of its own, up to 3 %, on the swaps it builds. It is shown in the build response as `integratorFee`, separately from the protocol fee. ## Pool fees Each pool a route passes through charges its own swap fee, set by that venue, not by FortiSwap. The quote reports it per hop as `feePpm` (parts per million) — for instance `2800` is 0.28 % — and the route search already accounts for it when ranking routes, so a route with more hops is only chosen when it nets out ahead. ## Network fee Every transaction also pays a small network fee that goes to the network itself, not to FortiSwap — what it is paid in depends on which network you are using. On **X1**, this is XNT, X1's own token; keep a little in your wallet for it. On **Arc** (currently a testnet preview — see [Arc](/docs/fortiswap/arc)), USDC is Arc's native currency, so the network fee is paid in test USDC directly, out of the same balance you are moving or swapping — there is no separate gas token to hold. FortiSwap's own protocol fee is the 0.25 % above, on top of whichever network's fee applies. ## Bridge and fiat legs A cross-chain route or a card purchase involves a third party, and that party's fee is itemised in the quote: * **Bridge routes** show the bridge's own fee and estimated time per route. The Solana ↔ X1 leg carries the bridge's flat **1 USDC** fee and no FortiBlox fee; the transfer window is **11 USDC minimum** (10 delivered plus the flat fee) up to **5,000 USDC**, reduced when less liquidity is available. Routes from an EVM source carry a FortiBlox fee of up to **0.25 %**, already included in the guaranteed minimum and itemised as its own row in the quote. * **Buy and Sell** show each payment option's total cost, and the options are ranked by what you actually receive after it. Minimums, maximums, and payment methods are the payment partner's and vary by region. FortiSwap adds no fee of its own to a card purchase or bank payout. Whatever the leg, the rule is the same: any fee that goes to FortiBlox is a visible row before you sign, never a deduction after. ## Fees on Arc Arc is currently a testnet preview (see [Arc](/docs/fortiswap/arc)), so nothing below moves real money yet, but the fee structure is real: * **Swap.** A swap settled through the on-chain Aggregator route carries the same 0.25 % protocol fee described above. A swap settled through Circle App Kit instead carries a FortiBlox fee of 25 basis points (0.25 %) on the input amount, on top of Circle's own small provider fee — you can see and compare venues before you confirm; see [Choosing how a swap settles](/docs/fortiswap/arc#choosing-how-a-swap-settles). * **Bridge.** Moving USDC between Arc and another test network uses Circle's CCTP directly, and it is a pure pass-through — FortiBlox adds no fee of its own to a bridge transfer. (Circle's own CCTP burn fee is currently zero on testnet.) --- # Words you'll see URL: /docs/fortiswap/glossary > Wallet, address, token, network, gas, bridge, slippage, price impact, signing — the handful of words that appear in FortiSwap, each explained in a sentence or two. # Words you'll see You do not need any of these to use FortiSwap. They are here for when you meet one on a screen and want to know what it means. **Wallet.** Your account on a blockchain: the place your funds live and the thing that authorises moving them. When you sign in to FortiSwap, wallets are created for you and looked after for you; you can also bring one you already have. A wallet is controlled by a secret key, and whoever holds the key controls the funds — which is why FortiSwap never holds yours. **Address.** A wallet's public account number — a long string of letters and digits. Sharing it is safe; it lets people send to you and lets anyone see the wallet's activity on a public explorer, but it cannot be used to spend. **Token.** A unit of value on a blockchain. Some track a real-world currency (USDC tracks the US dollar), some are a chain's own currency (XNT on X1), and some belong to a project. FortiSwap shows a trust tier next to every token as a starting point for your own judgement. **Network, or chain.** A blockchain — X1, Solana, Ethereum, Base, and so on. Each keeps its own records, so a token on one chain is not automatically on another; moving between them takes a bridge. **Network fee, or gas.** The small charge every action on a chain pays to the computers that run it. On **X1** it is paid in XNT, which is why FortiSwap keeps a little XNT back for you. On **Arc**, there is no separate gas token at all — USDC is Arc's own native currency, so the fee comes straight out of the same USDC balance you are moving or swapping (see [Using FortiSwap on Arc (testnet)](/docs/fortiswap/arc)). Either way, it goes to the network, not to FortiSwap. **Bridge.** A service that moves value from one chain to another. FortiSwap's Bridge tab quotes the transfer, including the bridge's own fee and how long it takes, before you confirm. **Swap.** Exchanging one token for another. FortiSwap finds the route across every pool on X1 that gives you the most, and shows it to you. **Pool.** A shared pot of two tokens that anyone can trade against. The price moves as people trade; a large trade in a small pool moves it a lot. **Price impact.** How much your own trade moves the price. Small in a deep pool, large in a shallow one. FortiSwap warns you above 5 %, asks you to acknowledge between 10 % and 20 %, and stops you at 20 % unless you turn on Expert mode. **Slippage.** The difference between the price you were quoted and the price you get, because the market moved in the seconds before your trade landed. Your slippage setting is a floor: if the fill would be worse than that, the trade is cancelled on-chain instead of going through. **Minimum received.** The least you will get from a swap, computed from the quote and your slippage. It is enforced by the network, not by a promise. **Signing.** Authorising a transaction with your wallet's key. With a sign-in wallet it happens when you press Confirm; with an external wallet it happens in that wallet's own window. Nothing moves until it is signed, and only the key holder can sign. **Transaction.** One signed action on a chain — a swap, a transfer, an order — with a unique signature you can look up on a public explorer. If you contact support about a specific action, this is the reference to include. **Non-custodial.** An app that never holds your funds or your key. FortiSwap builds transactions and hands them to your wallet; it cannot spend on your behalf. See [Security and trust](/docs/fortiswap/security). **Integrator.** An app or service that builds swaps through the FortiSwap [API](/docs/fortiswap/api) for its own users. An integrator may add a fee of its own on top of the protocol fee; it is shown as a separate line in the build response. **Explorer.** A public website that shows every transaction on a chain. Anyone can look up an address or a transaction; nothing on it is private, and nothing on it can be edited. **Route.** The specific path a swap takes through one or more pools to get from your input token to your output token. FortiSwap searches every viable route for your exact amount and picks the one with the best net output; the review screen and the [API](/docs/fortiswap/api) both show it. **Hop.** One leg of a route — a single pool. A **direct** swap is one hop; a **multi-hop** swap chains two or more pools together when that gets you a better price than the direct pair, or when no direct pair exists. **Split.** When a single swap is divided across two or more routes at once — each portion taking a different path — because that combination out-prices sending the whole amount through any one route alone. **Confidence.** A score FortiSwap attaches to a quoted route, folding in its price impact, hop count, and how deep the pools behind it are. It's a shorthand for how comfortable you should be with a route, not a guarantee of the outcome. **Trust tier.** A label FortiSwap shows next to every token — Verified, Community, New, Caution, or Danger — derived from on-chain signals like how long it's traded and how deep its liquidity is. It's a starting point for your own judgement, not a certification. **Priority fee.** An optional extra payment, on top of the base network fee, that makes a transaction more attractive to land promptly — useful when a network is busy or when you want a swap to beat a fast-moving price. FortiSwap sets a sane default and lets you raise it in Settings. **Compute unit.** The unit X1 (a Solana-compatible network) measures a transaction's on-chain work in. A swap that touches more pools or does more on-chain logic consumes more compute units; the built transaction reports how many it used. **x402.** An open, machine-friendly payment protocol built on the HTTP `402 Payment Required` status: a client requests a priced endpoint, receives a `402` describing the price, pays in USDC, and retries the same request with proof of payment attached. It's how FortiSwap's API sells access to automated agents without an account or an API key — see [Agents: pay-per-call access](/docs/fortiswap/agents). **MEV.** Value a party other than you can extract from a transaction by controlling its order or timing — for example, a bot buying just ahead of your trade and selling just after it. FortiSwap's slippage floor and MEV-protection setting both exist to limit the room for this. **Simulation.** Running a transaction against the current chain state without actually submitting it, to see whether it would succeed and what it would do. FortiSwap simulates every transaction it builds before handing it to your wallet, so a transaction that would fail is caught and reported instead of being signed. **DCA (dollar-cost averaging).** Buying (or selling) a fixed amount on a regular schedule instead of all at once, to average into a price over time rather than betting on a single moment. One of the two execution modes for a [Recurring order](/docs/fortiswap/how-to#recurring-dca-and-twap). **TWAP (time-weighted average price).** A recurring order's other execution mode: slicing the same schedule to reduce the price impact of each individual fill, rather than strictly even amounts. **OCO (one-cancels-the-other).** A pair of orders — typically a take-profit and a stop-loss — placed together so that whichever fills first automatically cancels the other. See [Orders](/docs/fortiswap/how-to#orders). --- # Using FortiSwap URL: /docs/fortiswap/how-to > The newcomer path — sign in with an account you already have, add funds by card, bank, or transfer, make your first swap — with plain-language explanations of what just happened. Then the bring-your-own-wallet path, bridging, orders, and settings. # Using FortiSwap This is the walkthrough for **X1**, FortiSwap's established network, where the money is real. The app at [app.fortiblox.com](https://app.fortiblox.com) has five tabs — **Swap**, **Bridge**, **Orders**, **Buy**, and **Sell** — and one settings panel that applies to all of them. If you have never used a crypto app before, start with the first section and stop when you have what you need. If you already have a wallet, skip to [Bring your own wallet](#bring-your-own-wallet). Looking for **Arc** instead — the network FortiSwap opens to by default, currently a testnet preview? See [Using FortiSwap on Arc (testnet)](/docs/fortiswap/arc). Words in this guide that may be new — wallet, token, network fee, and so on — each get a one-line definition where they first appear, and all of them are collected on [Words you'll see](/docs/fortiswap/glossary). ## Your first minute ### Sign in Press **Connect** in the top-right corner and choose **Email or social login**. Sign in with your email address, Google, X, Discord, GitHub, Telegram, or a passkey — whichever you already use. **What just happened.** FortiSwap created a *wallet* for you: an account on the blockchain that holds your funds, which only you can spend from. You got one for X1 (it also works on Solana) and one for EVM chains such as Ethereum and Base. The key to each wallet is split across secure hardware so that no one — not FortiSwap, not FortiBlox — can use it without you. There is nothing to download and nothing to write down. Sign in again from any device and the same wallets are there. ### Add funds Open the **Buy** tab, enter an amount, and choose how to pay. In supported regions you can use a debit or credit card or a bank transfer; the card shows the options available in your country side by side, ranked by how much you actually receive. Pick one, complete the payment in its checkout, and the funds appear in your wallet a few minutes later. If you already hold crypto somewhere else — an exchange, a friend, another wallet — open your wallet from the top-right corner, choose **Receive**, and send to the address shown. An *address* is your wallet's public account number; it is safe to share. **What just happened.** You bought USDC, a *token* that tracks the US dollar one to one, and it was delivered to your own wallet — not to an account FortiSwap holds for you. The identity check and the payment itself were handled by a regulated payment partner; FortiSwap never sees your card details. ### Swap Open the **Swap** tab. The top box is what you pay with, the bottom box is what you want. Pick the two tokens, type an amount (or use the **25 % / 50 % / 75 % / MAX** shortcuts), and the card shows what you will receive. Press **Swap**, check the summary, and press **Confirm swap**. **What just happened.** FortiSwap searched every place on X1 where those two tokens trade, found the route that gives you the most, and sent the trade from your wallet to the network. Because you signed in rather than installing a wallet, confirming happened with one press and no pop-up. The amount shown as **minimum received** was a guarantee: if the market had moved against you by more than that before the trade landed, it would have been cancelled rather than filled badly. ### Done Your new balance shows in the card and in your wallet. Every trade you make is visible on a public explorer with your wallet as the sender — there is no FortiSwap account in between. **Keep a little XNT.** XNT is X1's own token, and every action on X1 costs a very small amount of it — the *network fee*, which pays the computers that run the chain. The **MAX** button keeps a reserve back for you automatically, and the card shows a **Low XNT** chip if you are running short. The first time you receive a new token, a small refundable XNT deposit also opens a slot for it in your wallet; FortiSwap handles this for you. ### When you want more * **Another wallet.** Open your wallet from the top-right corner to add a second wallet, import one you already have, or export the key of the current one and move it to any other wallet app. Signing in easily does not mean staying. * **Taking funds out.** The **Sell** tab turns USDC into a bank payout in supported regions. The **Bridge** tab moves value to Solana or an EVM chain — see below. * **A pause before a risky trade.** If a trade would move the price a lot (its *price impact*) or the pool is very small, the card says so before you can continue, and above 20 % impact it stops you unless you turn on Expert mode in Settings. This is deliberate. ## Bring your own wallet If you already have a wallet that supports X1, press **Connect** and pick it from the list; installed wallets show as **Detected**, and the others offer an install link on desktop or an **Open in …** link on mobile. Your wallet keeps your key, FortiSwap builds each transaction and asks the wallet to sign it, and nothing happens until you approve in the wallet's own window. Closing a review screen without approving sends nothing. For bridge legs that start on another chain you also connect a wallet on that chain: any Solana-standard wallet for a Solana source, or a browser-extension EVM wallet for an EVM source. You can also mix the two: sign in for the wallets FortiSwap creates, and connect an external wallet alongside them. The wallet switcher in the top-right corner lists every wallet you have and lets you pick which one a given action uses. ## Swap, in detail ### Pick the pair and amount Choose the token you pay with and the token you want. Type an amount or use the **25 % / 50 % / 75 % / MAX** shortcuts — MAX keeps back a small XNT reserve so you can still pay network fees. The card shows the live rate and a countdown ring; the quote refreshes every 10 seconds. ### Read the warnings on the card If the trade's price impact is high or the pool is thin, the card says so before anything else happens. Between 10 % and 20 % impact you tick **I understand and want to continue**; at 20 % and above the swap is disabled unless Expert mode is on. ### Review Press **Swap** to open the review screen. It shows what you pay and receive, the **minimum received** at your slippage, the price impact, the route (venues, hops, any split, and the saving against a direct swap), a confidence grade, and the fee line — the quote already includes the 0.25 % protocol fee. ### Confirm Press **Confirm swap**. With a sign-in wallet the trade is signed and sent immediately; with an external wallet, approve it in the wallet's window. The status moves through signing and confirming on X1, and balances in the card and wallet drawer update on their own once the transaction lands. ## Bridge in and out A *bridge* moves value from one blockchain to another. Open **Bridge**, pick the chain you pay from and the chain you receive on, and the card quotes the transfer with the bridge's fee and estimated time shown as line items. * **Into X1** from Solana or from Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Chain, Avalanche, Linea, Cronos, HyperEVM, Story, Monad, or Sui. * **Out of X1** to Solana or to those EVM chains. The destinations offered for a given source are the corridors that can execute end to end from the card; the picker only lists what will work. (TRON is reachable only as a destination from a Solana source, never from X1.) If you signed in, the wallets FortiSwap created for you on the source chain are used automatically. Otherwise connect the source-chain wallet when prompted. Confirm the destination address (it is fixed inside the transaction you sign), approve, and wait for the confirmation on the destination chain. The card tracks the transfer until it lands. ## Buy and sell with a card or bank account **Buy** purchases USDC and delivers it to your wallet; **Sell** turns USDC into a bank payout. Enter an amount and FortiSwap quotes the payment options available in your region side by side, ranked by how much you actually receive after their fees. Pick one and complete the purchase in that partner's checkout — identity verification, payment methods, and limits are theirs and are shown live in the card. Availability, methods, and limits vary by country. ## Orders Open **Orders** and pick a type from the row of tabs. Every type rests on the same on-chain order engine — the fill condition is what changes from one type to the next, not the guarantee behind it: an order can only ever fill at your minimum or better, or it reverts, there is no off-chain watcher that dies when you close the tab, and you can cancel from the Orders page at any time. | Type | Fires when | | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Limit** | The market crosses your trigger price. Optionally add a take-profit and/or stop-loss to make it a bracket; when both are on they form an OCO and filling one cancels the other. | | **Stop-loss** | The price falls to your stop. | | **Take-profit** | The price reaches your target. | | **Recurring** | On a schedule — standard DCA or TWAP slicing, with an optional price band. | | **Trailing stop loss** | A stop that ratchets up on-chain as the price climbs and fills on the retrace. | | **Ladder** | Sells across up to eight ascending take-profit rungs. | ### Limit Set a trigger rate (output per input) and how much you're selling. Pick an expiry — **Never** (good-til-cancelled), or 1 hour, 1 day, 3 days, 7 days, or 30 days. Optionally tick **Add take-profit** and/or **Add stop-loss** to attach a second trigger without leaving the form: with both ticked, the take-profit must sit above the stop-loss, and together they behave as an OCO (below) riding on the same order. ### Stop-loss and take-profit A single trigger with a direction: stop-loss fills when the market falls **to or below** your price, take-profit fills when it rises **to or above** it. Use a stop-loss to cap a loss on a position you're already holding, and a take-profit to lock in a gain without watching the chart. Each carries the same expiry choices as a Limit order. ### OCO (one-cancels-the-other) A take-profit leg and a stop-loss leg placed together as a single pair: whichever triggers first fills, and the other is cancelled automatically — there is no window where both could fill. This is what a Limit order's attached take-profit + stop-loss actually places under the hood; it also exists as its own form if you want to bracket a position you already hold rather than a fresh entry. ### Recurring (DCA and TWAP) Spend or sell a set amount on a repeating schedule instead of all at once. Choose a direction (buy or sell), how many rounds (2 or more — a fixed count splits your total evenly across rounds, or leave it open-ended to run "until cancelled" at a set amount per cycle), and a frequency in minutes, hours, days, weeks, or months. **Standard** spaces equal-sized purchases evenly across the schedule — classic dollar-cost averaging; **TWAP** targets reduced price impact per slice over the same schedule instead of a strictly even split. An optional USD price band restricts fills to a range you set, so a cycle simply skips if the market is outside it when its turn comes. ### Trailing stop loss Set a trail distance as a percentage (0.01 % to 50 %) rather than a fixed price. The trigger starts at that distance below the market and ratchets up on-chain as the price climbs to a new high, then fills once the market retraces back down through the trigger — so it locks in more of a rally the longer it runs, without you resetting a stop by hand. A trail tighter than roughly 1 % may not be reliably fillable, since the market needs room to move back through it; the form warns if you set one that tight. ### Ladder Scale out of a position across up to eight rungs instead of selling all at once at a single target. Each rung is a portion of your total (the portions must add up to 100 %) and a target price, and prices must strictly ascend from the first rung to the last. Every rung fills independently once its price is reached — you don't need every rung to hit before any of them pay out — and any rung that hasn't filled can still be cancelled on its own. Rungs spaced closer than roughly 1 % apart may not both be reliably fillable; the form warns rather than blocks. ### Review and placing Set your terms, press **Review**, and check the summary — the review draws your trigger lines on a price chart and lists the trigger, what you sell, what you would receive at the trigger, the expiry, and the 0.25 % platform fee. **Approve & Place** signs the order and it rests on-chain from that moment. ## Settings Open **Settings** from the gear in the top navigation, or by tapping the slippage row on any review screen. | Setting | Default | Range | | ------------------ | ---------- | --------------------------------------------------------------------- | | **Max slippage** | Auto (5 %) | Custom 0.01 % – 50 % | | **MEV protection** | On | Caps effective slippage at 5 % even when a higher custom value is set | | **Priority fee** | 0.002 XNT | Up to 0.5 XNT | | **Max hops** | Auto | 1 – 4; fewer hops means a simpler, easier-to-verify route | | **Swap deadline** | 30 minutes | How long the swap stays valid before it expires unfilled | | **Expert mode** | Off | Unlocks swaps at 20 % impact and above behind a two-step confirm | Raising slippage makes a swap more likely to fill and more likely to fill badly. Use the pair-specific **recommended slippage** the card offers on thin pools rather than guessing, and leave MEV protection on unless you have a reason to accept the extra room for front-running. ## Getting help The **Contact support** form in the app footer sends straight to the team, or email [support@fortiblox.com](mailto:support@fortiblox.com). Include the transaction signature if your question is about a specific swap. --- # Security and trust URL: /docs/fortiswap/security > FortiSwap is non-custodial — every transaction is signed in your wallet and settles on-chain, and the claims on this page are the ones you can check yourself. # Security and trust This page lists what FortiSwap guarantees and, for each guarantee, how you would check it without trusting FortiBlox. It deliberately makes no claims that cannot be checked that way. ## Non-custodial by construction FortiSwap never holds your funds and never holds a key that can move them. * **External wallets** keep your key in the wallet. FortiSwap builds a transaction and asks the wallet to sign; the wallet shows you what it is signing, and nothing happens until you approve. * **Sign-in wallets** — the ones created for you when you sign in with email, Google, X, Discord, GitHub, Telegram, or a passkey — are self-custody wallets whose key is split across secure hardware enclaves. Only you can use it, FortiSwap cannot, and you can export the private key at any time and leave. * **Orders** rest on-chain in escrow under terms you signed — a minimum output or nothing — and are cancellable by you at any time. There is no off-chain balance and no withdrawal step. * **Bridge and fiat legs** deliver to the wallet address fixed inside the transaction you sign. Card purchases are made with the payment provider directly; FortiSwap never receives your card details. *Check it:* every swap, order, and bridge transaction is visible on a public explorer with your wallet as the signer — an X1 explorer for X1 activity, [ArcScan](https://testnet.arcscan.app) for Arc's testnet activity. There is no FortiSwap-controlled account in the path of your funds, on either network. ## What is checked before you sign * Every transaction the app or API produces is **simulated** before it is returned; a transaction that would fail is rejected with the program's own error rather than handed to your wallet. * Quotes are built from **live-verified reserves** and carry a **slot expiry**; a stale quote is never submitted. * **Slippage is enforced on-chain.** The minimum output is part of the transaction, and the program reverts if a fill would come in below it. The MEV-protection cap (5 % effective slippage) bounds what a sandwich could extract; it is a cap, not a promise that no MEV exists. * **Price-impact limits** apply in the app and again when the transaction is built, so they hold even if the interface is bypassed. Above the 25 % cap, no route is built. * **Token trust tiers** — Verified, Community, New, Caution, Danger — are derived from on-chain signals and shown wherever a token appears. They are a signal for your own research, not a verdict. ## What FortiSwap does not do * It does not custody funds, batch user transactions, or sign on anyone's behalf. * It does not run the bridges it integrates. Each corridor is operated by its own bridge, and that bridge's fee and timing are shown per route. * It does not perform identity verification or payment processing. Those belong to the regulated payment partner you choose in the Buy and Sell tabs. ## Reporting a problem Security reports go to [security@fortiblox.com](mailto:security@fortiblox.com). Anything else — a stuck bridge transfer, a swap that did not fill as expected — to [support@fortiblox.com](mailto:support@fortiblox.com) or the **Contact support** form in the app, with the transaction signature. FortiSwap's [Terms](https://app.fortiblox.com/terms), [Privacy Policy](https://app.fortiblox.com/privacy), and [AML statement](https://app.fortiblox.com/aml) are published in the app. --- # FortiSwap Pro URL: /docs/pro > FortiSwap Pro is the X1 trading platform — a Telegram bot, a web dashboard, and an AI assistant in a single trading suite, with instant swaps, sniping, copy trading, and automations.
A Telegram bot, a web dashboard, and an AI assistant in a single trading suite. Execute one-tap swaps, snipe new launches, run set-and-forget automations, copy other wallets, and ask a natural-language assistant about your portfolio and the wider market.} ctaHref="/docs/pro/getting-started" ctaLabel="Set up and make your first trade" /> ## What FortiSwap Pro is FortiSwap Pro is the flagship X1 trading platform. It combines a Telegram bot ([t.me/fortiswap\_bot](https://t.me/fortiswap_bot)), a web dashboard ([pro.fortiblox.com](https://pro.fortiblox.com)), and an AI assistant into a single trading suite. Your bot wallets are held by FortiSwap Pro (the keys are stored encrypted on our servers so the bot can trade for you); on the web you can also connect your own browser wallet, which keeps its keys. Sign in to the dashboard with a code from the bot and your bot wallets, orders and automations are there too: a limit order set in Telegram is visible on the dashboard, and vice versa. Start with the [Introduction](/docs/pro/intro) for the full feature list and what is live today.
--- # Automations (TWAP, Grid, DCA, TP-Ladder, Martingale) URL: /docs/pro/automations > Set-and-forget trading strategies you can run on XNT-paired tokens # Automations FortiSwap Pro ships a full set of automation strategies for XNT-paired tokens. Each one runs automatically against a wallet you specify — you don't have to keep the dashboard open. On the dashboard, TWAP, DCA and TP-Ladder live in the **Trade** panel (Orders → TWAP, DCA, and the advanced swap options); Grid, Martingale, Rebalance, Trend and the templates live under **Automations**. ## The five strategies | Strategy | What it does | Best for | | -------------- | ---------------------------------------------------------------------------------------- | ------------------------------------------------------------- | | **TWAP** | Splits a target size into equal slices over a time window | Entering or exiting large positions without moving the market | | **Grid** | Buys on the way down and sells on the way up across a defined price range | Ranging markets where price oscillates around a level | | **DCA** | Recurring buy (or sell) of the same XNT amount at a fixed interval | Long-term accumulation, timing-agnostic | | **TP-Ladder** | Sells fixed percentages at ascending price rungs | Scaling out of winners | | **Martingale** | Adds larger safety orders as price falls, then sells the whole position at a take-profit | High-risk mean-reversion plays only | Martingale can wipe an account if the trend continues against you. It is not a recommended default. Cap the number of safety orders and use it only on assets you already believe are mean-reverting. ## TWAP (Time-Weighted Average Price) Instead of one big buy or sell, TWAP breaks the target size into N equal slices and executes them over a chosen window. ### When to use it * You want to buy 1,000 XNT of a mid-cap token and know a single tx would move the price * You want to distribute-sell a moon-shot position without triggering a cascade ### Configuration * **Side** — buy or sell * **Total size** — total XNT (buy) or token amount (sell) * **Slices** — number of executions (e.g. 12) * **Interval** — time between slices (e.g. 5 minutes, so 12 slices take an hour) * **Slippage cap** — a slice fails if slippage exceeds this * **Wallet** — which of your wallets to execute from ### Behavior Slices fire on a fixed schedule. If a slice fails, it is retried instead of skipped. After 3 failed attempts in a row, the TWAP stops and is marked failed. ## Grid Trading Grid trading defines a price range and a number of grid levels within it. As price crosses levels, the strategy alternately buys and sells fixed sizes. ### Configuration * **Token** — the XNT-paired token * **Upper bound / Lower bound** — grid range * **Grid levels** — number of buy/sell rungs * **Total investment** — split across the rungs * **Max loss % / stop on breakout** — optional safety stops * **Wallet** — execution wallet ### Behavior Say you set 10 grid levels between 0.10 XNT and 0.20 XNT. As price crosses each level going down, the strategy buys. As it crosses each level going up, it sells. In a ranging market you accumulate XNT profit from each round trip. Grid trading is *the* set-and-forget strategy for stablecoin-adjacent or range-bound pairs. It is bad for strongly-trending assets — you'll get filled all the way to the lower bound and hold a losing bag. ## DCA (Dollar Cost Average) Recurring buy (or sell) of the same XNT amount at a fixed interval — regardless of price. ### Configuration * **Token** — target token * **Side** — buy or sell * **Amount per buy** — XNT per interval * **Interval** — for example 1h, 6h or 1d * **End condition** — number of buys or total amount * **Wallet** — buying wallet In Telegram: `/dca_start `, `/dca_list`, `/dca_stop `. ### Behavior Buys are executed on schedule. Progress is visible in the dashboard and with `/dca_list`. ## TP-Ladder (Take-Profit Ladder) Instead of a single take-profit, sell in stages as the price climbs. ### Configuration * **Position** — token you already hold * **Entry price** — in XNT * **Rungs** — list of `(multiple of entry, sell_percentage)` pairs; the last rung sells what is left In Telegram, save a profile with `/tp_profile_save ` (for example `2x@25,5x@25,10x@50`) and apply it with `/tp_create `. ### Example Buy at 0.05 XNT. Set the ladder: | Trigger | Sell | | ------------ | ---- | | 0.075 (1.5×) | 25% | | 0.10 (2.0×) | 25% | | 0.15 (3.0×) | 50% | If the token goes to 2× and then dumps, you locked half the position at good prices. Add a separate trailing stop (`/trailing`) if you want protection on the rest. ## Martingale Buy an initial order, then add a larger "safety order" each time price falls by a set step, which lowers your average entry. When price recovers to your take-profit, the whole position is sold and a new round can start. ### Configuration * **Token** — target token * **Initial order** — first buy, in XNT * **Safety order size and volume scale** — how big each extra buy is, and how fast it grows * **Price deviation and step scale** — how far price must fall before each safety order * **Max safety orders** — hard cap on the number of extra buys (always set this) * **Take-profit %** (optional trailing) and optional **stop-loss %** * **Wallet** — execution wallet Safety orders compound. With a volume scale of 2 and 3 safety orders, one bad streak commits 1 + 2 + 4 = 7× your safety order size on top of the initial order; 5 safety orders commit 31×. Keep the cap low. ## Trend Following (experimental) FortiSwap Pro includes a rules engine for trend-following configs (EMA crossover, RSI, MACD, volume surges, etc.). It is **available but experimental**: the surface has not been battle-tested. We list it here because it exists in the dashboard, not because we recommend it yet. There is also a **Rebalance** strategy that keeps a set of tokens at target weights. ## Managing your automations The Automations page in the dashboard lists every strategy you've configured, with status (running / paused / finished / errored), fill count, and PnL. From Telegram, each strategy has its own menu and create command: ``` /grid /newgrid /martingale /newmartingale /trend /newtrend /rebalance /newrebalance /dca_list /dca_stop /tp_list /tp_cancel ``` ## Strategy templates To speed up setup, we ship a set of pre-configured strategy templates (currently 6) — for example "Conservative DCA (Weekly)" or "XNT Grid (Tight Band)." Pick a template under **Automations → Templates**, adjust the token and size, and go. ## Related pages --- # Charts & Market Intel URL: /docs/pro/charts > TradingView Advanced Charts, trade overlays, Smart Money Score, the token security strip, and Trade Replay # Charts & Market Intel FortiSwap Pro ships a full chart stack with several overlays designed specifically for X1 trading. The chart is not just for price — it's the surface for your own trades, whale activity, Smart Money flow, and trade replay. ## Chart engine ### TradingView Advanced Charts The dashboard uses TradingView Advanced Charts. This is the full TradingView charting library: * All standard indicators (RSI, MACD, MAs, Bollinger, etc.) * Drawing tools (trendlines, Fib retracements, positions) * Timeframes from 1m to 1D (1m, 5m, 15m, 1h, 4h, 1D) * Chart layouts you can save The chart is fed by FortiSwap Pro's own price pipeline, built from on-chain pool data. ## Trade overlays The **Overlays** row above the chart has two modes: * **My Trades** — marks your connected wallet's buys and sells on the chart * **Whales** — marks trades above the whale size threshold Use them to verify a suspiciously bad fill on one of your own trades, or to see when large wallets are moving a token. ## Indicator overlays Next to the trade overlays you can switch on VWAP, Volume Profile, RSI, MACD, CVD, a log scale, and two X1-native indicators: **NBP** (Net Buy Pressure, the buy vs sell ratio per candle) and **FWB** (Fresh Wallet Buying, how much of the buying came from wallets less than 24 hours old). ## Smart Money Score The **SMS** (Smart Money Score) indicator draws a histogram in its own pane: for each candle, how concentrated the trading was among wallets our classifier labels Smart Money. Smart Money classification is done off-chain by the wallet-reputation engine. ## Trade Replay scrubber The **Trade Replay** scrubber lets you scrub back through the price action around a trade and see every trade tick-by-tick. Right-click a trade marker on the chart (or long-press on mobile) and choose **Replay trade at this time**; use the arrow keys to step through events. Especially useful for: * Post-mortem: "Why did my TP fill at that price?" * Rug analysis: "How did the dump happen?" * Sandwich analysis: "Was I actually front-run?" ## Token security strip Every token chart shows a slim security strip above the price. It shows the facts, not a score: | Fact | What it tells you | | ------------------- | -------------------------------------------------------- | | LP burned share | How much of the pool's liquidity can no longer be pulled | | Top-10 holder share | How concentrated the supply is | | Mint authority | Whether new tokens can still be minted | | Freeze authority | Whether token accounts can still be frozen | The strip is advisory — it does not block trades in the manual UI. Your anti-rug guard settings (`/anti_rug_status`) decide what is blocked on guarded buys. ## Related pages --- # Copy Trading URL: /docs/pro/copy-trading > Mirror trades from tracked wallets, with size caps, filters, and safety guards # Copy Trading Copy trading lets you mirror the on-chain activity of wallets you trust. When they buy, you buy the same token — with your own size, your own wallet, and your own safety guards. ## How it works 1. You add a **target wallet** to your copy list. 2. You configure **size and filters** (how much of their trade to copy, which tokens, which of your wallets to buy from). 3. When the target wallet places an on-chain trade, FortiSwap Pro detects it, checks your size caps and filters, and submits your mirrored trade. 4. Your trade is a fully independent swap from your own wallet — the target wallet has no visibility or control over your funds. ## Adding a wallet to copy ### Via dashboard Copy Trading page → **Add Wallet** → paste address → configure → **Enable copying**. ### Via Telegram ``` /copy [label] ``` Then fine-tune size and filters in **Copy Trade → Settings** or with `/copysettings`. ## Configuration options ### Copy size Copy size is a **percentage of the target's trade** (1–100%). **Example:** target buys 10 XNT worth of a token; you set 50% → you buy 5 XNT worth. ### Size caps (always set these) * **Max amount per trade (XNT)** — cap on a single mirror, protects against copying an outlier trade * **Daily limit total (XNT)** — cap on total mirrored spend per day (dashboard) * **Daily limit per token (XNT)** — cap per token per day (dashboard) * **Max pending trades** — how many mirrors can be in flight at once (dashboard) ### Token filters * **Whitelist** — only copy trades on these tokens (dashboard) * **Blacklist** — copy everything except these (Telegram: **Blacklisted Tokens** or `/copysettings skip `) ### Buys and sells * **Copy buys** — on or off * **Copy sells** — sell when the target sells; turn it off to manage exits yourself with your own TP-Ladder or stop-loss Slippage and priority fee can be set per wallet as well. ## Managing tracked wallets ``` /following # show the wallets you follow /unfollow # stop copying a wallet /pausecopy # pause all copying, keep the config /resumecopy # resume /copyhistory # recent copied trades /copystats # your copy-trade performance ``` Or the equivalent buttons on the Copy Trading page in the dashboard. ## Performance tracking For each tracked wallet you can see: * Copied trades and their results * Skipped trades, each with its reason * PnL from mirrored trades It is fine and expected for some percentage of attempts to be skipped — that's your caps and filters doing their job. ## Wallet under-funding Copy trading requires your buying wallet to hold enough XNT to fill the mirrored size, plus network fees. If it's underfunded when the target trades, the attempt is recorded as skipped for insufficient balance and the target's trade is not mirrored. This is not a bug — a trade is only recorded as a success once it lands on-chain. ## Risk management ### Diversify Don't copy just one wallet. Copy 3–5, ideally with different styles (aggressive scalper + swing trader + conservative accumulator). One target's losing streak shouldn't sink your portfolio. ### Pause underperformers If a tracked wallet's mirrored trades keep losing, pause or unfollow it. This limits blast radius when a target starts revenge-trading. ### Position limits * Daily limit total (defense-in-depth on top of per-trade caps) * Max pending trades ## Finding wallets to copy Good candidates typically show: * 30+ days of consistent activity * Realized PnL clearly positive (not just holding a moonshot) * Reasonable drawdowns * A recognizable style (momentum, mean-reversion, accumulation) rather than random Red flags: * Only recent gains * Extreme trade frequency (bot vs. human) * Suspicious win rates (\~100%) * History of trading known scam tokens Discover candidates through the dashboard **Leaderboard** and **Smart Wallets** pages, the Smart Money Score on charts, or on-chain research. ## Troubleshooting ### Nothing is copying * Confirm the target wallet actually placed a trade (check the explorer) * Check your wallet's XNT balance * Check your size cap isn't below the mirror size * Check filter settings (whitelist too tight?) * Check the skip history for reasons ### Copies are late * Raise the priority fee for that wallet * Network congestion on X1 * Target may be using a private mempool path you can't front-run ### Unexpected copies * Blacklist not applied correctly * Target using new tokens you didn't anticipate — tighten whitelist ## Best practices 1. **Start small** — 0.1 XNT per copy for the first 100 mirrored trades to validate the target 2. **Cap everything** — per-trade and daily caps 3. **Mirror + independent exit** — copy their buys, but manage your own exits 4. **Watch the skip history** — it tells you when your caps and filters are protecting you 5. **Re-evaluate weekly** — pause underperformers, don't average down on a target --- # Dashboard Guide URL: /docs/pro/dashboard > Navigate the FortiSwap Pro web dashboard for advanced trading features # Dashboard Guide The FortiSwap Pro web dashboard provides a comprehensive interface for managing your trading activities, viewing analytics, and configuring advanced settings. **Dashboard URL**: [pro.fortiblox.com](https://pro.fortiblox.com) ## Connecting Your Wallet ### Sign in with your bot wallets 1. Visit [pro.fortiblox.com](https://pro.fortiblox.com) and open the sign-in window 2. Under **Have bot wallets?**, click **Get a sign-in code** 3. Send the `/web ` command it shows to the bot in Telegram, then tap **Approve** there (the code lasts 5 minutes) 4. Your dashboard will sync with your bot wallets ### Other ways to sign in You can also: * Connect a browser wallet (X1 Wallet or Backpack). It keeps its own keys and signs each transaction itself. * Sign in with X1ID * Sign in with email or a social account ## Dashboard Overview ### Main Navigation The top bar links the main sections: * **Trade** — Swap, Bridge, Orders, Buy and Sell, with charts on every token page (see [Charts & Market Intel](/docs/pro/charts)) * **Discover** — Trending, gainers, losers, new pairs (see [Trending Tokens](/docs/pro/trending-tokens)) * **Portfolio** — Current holdings, active orders, trade history * **Automations** — Templates, snipers, Grid, Martingale, Rebalance and Trend (see [Automations](/docs/pro/automations) and [Sniping](/docs/pro/sniping)) * **Copy trade** — Manage copied wallets The **All features** menu adds: * **Dashboard** — Overview and quick stats * **Alpha Feed**, **Leaderboard**, **Smart Wallets**, **Trenches** and **Watchlist** * **Earn** — Liquid staking, validator staking and referrals * **Settings** and **Support** The **Forti** assistant opens from its own button on every page (see [Forti AI Assistant](/docs/pro/forti-ai)). ## Dashboard Home The main dashboard displays: ### Portfolio Value * Total portfolio value * 24h change percentage ### Quick Stats * Positions * Total P\&L * Win rate ## Trading Interface ### Buy Tokens 1. Enter or paste token contract address 2. View token info and chart 3. Select amount (preset or custom) 4. Review slippage and priority fee settings 5. Click **Buy** to execute ### Sell Tokens 1. Navigate to **Portfolio** 2. Select token to sell 3. Choose percentage or amount 4. Review and confirm 5. Click **Sell** to execute ### Advanced Options * **Max slippage**: Set max acceptable slippage * **Priority Fee**: Adjust transaction priority * **MEV protection**, **Swap deadline** and **Max hops** ## Positions View ### Portfolio Breakdown The Portfolio page has tabs for Positions, Active Orders, History, Trades and NFTs, with unrealized PnL per position. ### Position Details Each position shows: * Token name and symbol * Current price * Entry price * Quantity held * Current value * PnL (% and $) ## Orders Management ### Active Orders View all pending orders: * Take Profit orders * Stop Loss orders * Trailing stops * DCA orders ### Order Details Each order displays: * Order type * Token * Trigger price * Sell percentage * Created date * Status ### Manage Orders * **Edit** - Modify order parameters * **Cancel** - Remove order ## Copy Trading Panel ### Tracked Wallets View wallets you're copying: * Wallet address * Performance metrics * Trade history * Copy settings ### Add New Target 1. Click **Add Wallet** 2. Enter wallet address 3. Configure copy settings: * Copy percentage (% of their trade size) * Max amount per trade * Daily limits (per token and total) * Token filter (all tokens or a whitelist) * Copy buys / copy sells, slippage, priority fee 4. Enable copying ### Performance Analytics * Copied trades and skipped trades (with the reason) * Your PnL from copies ## Sniping Center Snipers live under **Automations → Snipers** (the Sniper and the Launchpad Sniper). See [Sniping](/docs/pro/sniping). ## Trade History The **Trades** tab on the Portfolio page is a complete log of your trades: * Date/time * Token * Type (buy/sell) * Amount * Price ### Export Data Download your trade history as CSV for tax reporting or analysis. ## Settings ### Trading Settings * Default slippage * Default gas multiplier * Auto-approve tokens * Quick-action button presets (buy and sell amounts) ### Notifications * Trade notifications * Order notifications * Copy trade notifications * Price alerts ### Security * Session timeout (auto logout after inactivity) * Linked sign-in accounts ### Display * Theme (Light/Dark) ## Mobile Access The dashboard is fully responsive and works on mobile devices: * Touch-optimized interface ## Tips for Power Users 1. **Use the command palette** - Speed up navigation 2. **Set up price alerts** - Never miss a move 3. **Review your trade history weekly** - Improve your strategy 4. **Export data regularly** - Keep records for taxes --- # Earn Hub URL: /docs/pro/earn-hub > Earn passive income through staking, liquid staking, and XP rewards # Earn Hub The Earn Hub is your gateway to passive income on FortiSwap Pro. Choose from multiple earning strategies based on your risk tolerance and liquidity needs. ## Getting Started Access the Earn Hub: * **Telegram:** Tap the "Earn" button in the main menu or use `/earn` * **Dashboard:** Open **Earn** from the All features menu ## Earning Options ## Comparison | Feature | Liquid Staking | Validator Staking | XP Rewards | | --------- | --------------------------- | ----------------- | ---------- | | APY | Variable | Variable | Variable | | Liquidity | Instant (from pool reserve) | Epoch-locked | — | | Minimum | 0.01 XNT | 0.01 XNT | None | | Risk | Pool risk | Validator risk | None | | Token | pXNT | XNT | XP → XNT | ## Liquid Staking (pXNT) Liquid staking lets you earn staking rewards while keeping your assets liquid. When you stake XNT, you receive pXNT - a liquid staking token that represents your staked position. ### How It Works ### Stake XNT Deposit XNT into the liquid staking pool. You'll receive pXNT at the current exchange rate. ### Hold pXNT Your pXNT automatically accrues value as staking rewards are distributed. The exchange rate increases over time. ### Unstake Anytime Convert pXNT back to XNT whenever you want. No lockup period - paid out instantly from the pool's reserve. ### Key Benefits * **Staking rewards** - see the current rate in the app * **No lockup** - Unstake anytime (small pool fees apply; see the Earn page) * **Composable** - pXNT is a standard token you can hold, send or trade * **Auto-compounding** - Rewards compound automatically ### Commands ``` /stake - Open staking menu /mystakes - View your staked positions ``` Learn more about liquid staking mechanics in our [Liquid Staking Guide](/docs/pro/liquid-staking). ## Validator Staking Stake directly with X1 validators to earn network rewards. This is traditional Proof-of-Stake staking. ### How It Works ### Choose a Validator Browse validators by APY, commission, and status. Use `/validators` to see the list. ### Stake XNT Delegate your XNT to your chosen validator. Minimum stake is 0.01 XNT. ### Earn Rewards Rewards are added to your stake each epoch (\~2 days), so they compound automatically. ### Unstake Request unstaking - funds are available after the current epoch ends. ### Key Features * **Direct staking** - Your stake secures the network * **Validator choice** - Pick validators you trust * **Epoch rewards** - Predictable reward schedule * **Compounding** - Rewards are added to your stake ### Commands ``` /validators - Browse available validators /stake - Stake with a validator /mystakes - View your delegations ``` ### Choosing a Validator When selecting a validator, consider: | Factor | What to Look For | | ---------- | ------------------------------------------- | | APY | Higher is better, but verify sustainability | | Commission | Lower commission = more rewards for you | | Uptime | 99%+ uptime indicates reliability | | Stake Size | Very large or very small may have risks | ## XP Rewards Earn XP (experience points) on the trades you make through the bot. XP is tracked by X1's XP program on [core.x1.xyz](https://core.x1.xyz), where you can redeem it for XNT and other rewards. ### How XP Works * **Earn XP** - Trades through the bot earn XP; higher volume earns more * **Bonus XP** - Active trading streaks earn bonuses * **Redeem** - Redeem XP on [core.x1.xyz](https://core.x1.xyz) Earning rates and redemption rates are set by the XP program on core.x1.xyz and can change. XP rewards are tracked automatically. Check your balance in Telegram under **💰 Earn → XP Rewards**. ## Comparing Options Use the "Compare Options" button in the Telegram Earn Hub to see a side-by-side comparison of all earning methods. ### Which Should You Choose? **Choose Liquid Staking if:** * You want a hands-off option without choosing a validator * You need liquidity (might need funds soon) * You want a staked position you can transfer or trade **Choose Validator Staking if:** * You want to support network decentralization * You have a long-term holding mindset * You prefer traditional staking mechanics **Choose XP Rewards if:** * You're already trading actively * You want additional rewards on top of trades * You prefer zero additional risk ## FAQ Yes! You can liquid stake some XNT, validator stake some XNT, and earn XP on trades - all simultaneously. Liquid staking has smart contract risk (pool could have bugs) and validator risk (if underlying validators misbehave). Rewards are distributed at the end of each epoch, approximately every 2 days on X1. XP is held by the XP program on core.x1.xyz, and its rules apply. Check core.x1.xyz for the current terms. --- # Forti AI Assistant URL: /docs/pro/forti-ai > A trader-scoped natural-language assistant that can read your portfolio, your trades, and current market state # Forti AI Assistant Forti is FortiSwap Pro's built-in AI assistant on the web dashboard. It uses a curated set of trader-scoped tools that let it read your live portfolio, your recent trades, market state, on-chain data, and the top tokens on X1. You ask questions in plain English; it answers in plain English. ## What Forti can actually answer Try asking things like: * "How's my portfolio today?" * "Which of my positions is up the most this week?" * "Show me the top 10 projects on X1 by 24h volume." * "Who are the smart wallets on TOKENX right now?" * "Who are the top holders of TOKENX?" * "Am I currently at risk on any position?" * "What automations are running on Wallet 2?" The style is deliberately conversational. Forti replies with sentences, not JSON dumps. If a question needs a table, it renders a table inline; if it needs a chart, it embeds one; otherwise it just talks. ## How it works * Forti runs against your live account. Every response is grounded in the actual state of your wallets and the current market — not a stale snapshot. * Its tools are **trader-scoped**: they can query your positions, your orders, your automations, and public market data, but not anyone else's account. * Answers include their sources (which tool was called, when the data was fetched) so you can verify. * The panel is theme-aware: it matches your dashboard's dark/light theme. ## The Live portfolio stream While the Forti panel is open, your portfolio and positions are streamed live. A small badge above Forti's reply shows the connection state: * **live** — real-time updates, with the time of the last update * **snapshot** — showing the last loaded snapshot, real-time stream connecting * **reconnecting** — stream dropped, refetching The panel starts from a full snapshot of your account, then applies live updates on top of it. This means the numbers you see are always both fresh *and* self-consistent, even during network hiccups. ## Where to find it * **Dashboard** — open Forti from its button on any page. Open, ask, keep it open while you work. * **Telegram** — Forti is not available in the bot. Use the dashboard to ask questions. ## Sample sessions The numbers below are made-up examples. **Portfolio check-in.** > **You:** How am I doing today? > > **Forti:** Your portfolio is up 4.2% today (+8.1 XNT), driven mostly by TOKENA (+18%) and TOKENB (+6%). Your largest drag is TOKENC (-9%), which is now 3% below your entry. You have an active stop-loss on TOKENC at -12% — no action needed unless you want to tighten it. **Discovery.** > **You:** What are the top projects on X1 right now? > > **Forti:** By 24h volume: 1) TOKENA (12.4M XNT), 2) TOKENB (8.1M), 3) TOKENC (6.7M), 4) TOKEND (4.3M), 5) TOKENE (3.9M). Do you want holder counts, price change, or smart-wallet activity for any of these? **Smart Money query.** > **You:** Who are the smart wallets on TOKENA? > > **Forti:** Three wallets classified as Smart Money currently hold TOKENA: wallet ABCD…1234 (bought 2h ago, up 22%), wallet EFGH…5678 (bought 4h ago, up 8%), and wallet IJKL…9012 (accumulating since yesterday, average entry 4% below current). Wallet ABCD…1234 in particular has a 68% 30-day win rate. ## The AI Explainer Alongside the assistant, we're rolling out an **AI Explainer** panel that surfaces plain-English rationale for automated trade decisions ("bought TOKENA because Grid rung 3 filled, size 0.5 XNT, current fill 22 / 30"). It is rolling out gradually, so you may not see it yet. ## Privacy and scope * Forti has read access to your account only. * Forti cannot execute trades on your behalf: its tools only read data. To trade, use the normal buy flow. * Prompts and responses are logged for debugging and safety, per the terms of service. Trader data is not shared with other users' Forti sessions. ## Tips for good answers * **Be specific.** "How's my portfolio?" is fine; "How did my copy-trade wallet do this week vs. my sniper wallet?" is better. * **Chain questions.** Follow-ups keep context — you don't have to re-specify the token you were just asking about. * **Ask for the source.** "Where did that number come from?" makes Forti cite the tool call. ## Related pages --- # Getting Started URL: /docs/pro/getting-started > Quick start guide to set up FortiSwap Pro and make your first trade # Getting Started with FortiSwap Pro Get up and running with FortiSwap Pro in just a few minutes. This guide walks you through the initial setup and your first trade. ## Step 1: Access the Bot 1. Open Telegram on your device 2. Search for `@fortiswap_bot` or click: [t.me/fortiswap\_bot](https://t.me/fortiswap_bot) 3. Click **Start** to begin ## Step 2: Create Your Wallet Send `/start`. If you don't have a wallet yet, the bot asks you to create or import one: ``` /start ``` Tap **Portfolio → Wallet → Create Wallet** (or send `/newwallet`). The bot shows: * Your new wallet address The wallet is held by FortiSwap Pro: its key is stored encrypted on our servers so the bot can trade for you. > **Important**: Back up your private key with `/export` (or **Export Key** in the wallet menu) and store it in a secure location. The key message is deleted automatically after 30 seconds. ## Step 3: Fund Your Wallet Send XNT to your wallet address to start trading: ``` /deposit ``` This shows your deposit address. Send XNT from any external wallet or exchange (X1 network only). ## Step 4: Make Your First Trade ### Buy a Token ``` /buy ``` The bot asks for the token contract address. Or simply paste a token contract address, and the bot will prompt you to buy. ### Quick Buy Amounts The bot provides preset buy amounts (change them with `/presets`): * 0.1 XNT * 0.5 XNT * 1 XNT * 5 XNT * Custom amount ### Sell a Token ``` /sell ``` Select from the tokens in your active wallet, then pick 25%, 50%, 75%, 100% or a custom percentage. ## Essential Commands | Command | Description | | ------------ | ------------------- | | `/start` | Main menu | | `/wallet` | Wallet management | | `/buy` | Buy tokens | | `/sell` | Sell tokens | | `/positions` | View open positions | | `/orders` | Manage limit orders | | `/settings` | Bot settings | | `/help` | Get help | ## Next Steps ## Safety Tips 1. **Never share your private key** - No one from FortiBlox will ever ask for it 2. **Start small** - Test with small amounts before larger trades 3. **Use limit orders** - Buy or sell at the price you choose 4. **Set stop losses** - Always protect your downside --- # Hardware Wallet Signing URL: /docs/pro/hardware-wallet > Admin-area tool for signing queued transactions with a Ledger over USB # Hardware Wallet Signing The dashboard's admin area includes a **Hardware Signers** page for signing queued transactions with a hardware wallet, without the private key ever touching our servers. It supports **Ledger** over USB (WebHID). Keystone pubkeys can be registered, but Keystone signing is not available yet. This is an operator tool, not part of the everyday trading flows. It lives at `/admin/hardware-signer`, is not linked from the standard navigation, and your buys, sells, snipes, copy trades and automations do not send transactions to it. Trading accounts sign with their bot wallet or their connected browser wallet. ## How the flow works 1. On the Hardware Signers page, you register your hardware wallet's public key with a label. 2. A transaction that needs that key is added to the page's queue as **pending**. 3. You review each pending tx, sign it on your hardware device, and the dashboard submits the signature. 4. The signed tx is broadcast to the X1 network like any other. Private keys never leave the device. FortiSwap Pro's servers only ever see signatures. ## Ledger (USB / WebHID) Requires: * A Chromium-based browser with WebHID support (Chrome, Brave, Edge, Arc) * The Solana app installed and open on the Ledger ### Connect 1. Open the **Hardware Signers** page 2. Add a signer and pick **Ledger** 3. Browser prompts you to select the device — pick your Ledger 4. Open the Solana app on the Ledger 5. The page displays your Ledger-derived pubkey ### Sign 1. See the pending tx queue on the Hardware Signers page 2. Click **Sign** on a pending tx 3. Approve on the Ledger device (review the fields on the device screen — always trust the device display, never the browser display) 4. The signed tx is broadcast; the row moves to "submitted" ## Keystone (QR) You can register a Keystone pubkey on the Hardware Signers page (add a signer, pick **Keystone**, give it a label and enter its pubkey), but QR signing is not available yet: the **Sign with Keystone** button is disabled. Use a Ledger to sign queued transactions. ## When to use hardware signing * **Treasury or shared wallets** — where policy requires an offline signer * **Long-term holdings** — keys you never want on a hot machine Hot-wallet execution is still the right path for day-trading, sniping, and copy trading — the speed you need on those flows is incompatible with a device confirmation on every trade. ## Access control The Hardware Signers page sits in the dashboard's admin area. Standard trader accounts do not see it in the navigation. ## Related pages --- # Introduction to FortiSwap Pro URL: /docs/pro/intro > The X1 blockchain trading bot with instant swaps, sniping, copy trading, automations, AI assistance, and a full web dashboard # FortiSwap Pro Trading Bot FortiSwap Pro is the flagship X1 trading platform. It combines a Telegram bot, a web dashboard, and an AI assistant into a single trading suite. You can execute one-tap swaps, snipe new launches, run set-and-forget automations, copy other wallets, and ask a natural-language assistant about your portfolio and the wider market. ## What you get ## Quick Links | Resource | Link | | ------------- | ------------------------------------------------- | | Telegram Bot | [t.me/fortiswap\_bot](https://t.me/fortiswap_bot) | | Web Dashboard | [pro.fortiblox.com](https://pro.fortiblox.com) | ## Two ways to trade FortiSwap Pro meets you where you are: * **Telegram** — Everything the bot can do can be driven from a Telegram chat. This is the fastest way to react on mobile and is the interface most users start on. * **Web dashboard** — The full experience: portfolio overview, TradingView charts, automations builder, the Forti AI assistant, and the token-intel matrix. Sign in to the dashboard with a code from the bot and you see the same bot wallets and the same order/automation state. A limit order set in Telegram is visible on the dashboard, and vice versa. Browser wallets you connect on the web are used on the web only. ## Why FortiSwap Pro? * **Clear custody.** Bot wallets are held by FortiSwap Pro: the keys are stored encrypted on our servers so the bot can trade for you, and you can export a key at any time. Browser wallets you connect on the web keep their own keys and sign every transaction themselves. * **Fast.** Confirmations usually take a few seconds, depending on the network. * **Safe by default.** Anti-rug checks and a single-transaction swap — the 0.25% fee is charged inside the same on-chain swap, so a failed swap never costs you a swap fee — reduce the "stuck in a bad position" failure modes that plague other bots. * **AI-native.** The Forti assistant is trader-scoped: it can read your portfolio, your recent trades, and current market state, and answers plainly instead of dumping raw data. ## Getting Started Ready to start trading? Follow our [Quick Start Guide](/docs/pro/getting-started) to set up your first wallet and make your first trade. --- # Liquid Staking URL: /docs/pro/liquid-staking > Stake XNT, receive pXNT, earn staking rewards with full liquidity # Liquid Staking with pXNT Liquid staking allows you to earn staking rewards while maintaining full liquidity. Stake XNT, receive pXNT, and unstake anytime - no lockup periods. ## What is pXNT? pXNT (pooled XNT) is a liquid staking token that represents your staked XNT position. When you stake XNT into the liquid staking pool, you receive pXNT in return. ### Key Properties | Property | Value | | ------------- | ---------------------------------------------- | | Token | pXNT | | Underlying | XNT | | APY | Variable; the current rate is shown in the app | | Lockup | None | | Minimum Stake | 0.01 XNT | | Pool Fee | Shown on the Earn page | ## How It Works ### Stake XNT Deposit XNT into the liquid staking pool. You receive pXNT at the current exchange rate. ### Exchange Rate Grows As staking rewards accrue, the pXNT:XNT exchange rate increases. Your pXNT becomes worth more XNT over time. ### Unstake Anytime Convert pXNT back to XNT at the current exchange rate. You receive your original stake plus accumulated rewards. ## Exchange Rate Mechanics Unlike rebasing tokens, pXNT uses an exchange rate model: * **When you stake:** 1 pXNT = 1.000 XNT (example) * **Later:** 1 pXNT = 1.050 XNT (example) Your pXNT balance stays the same, but each pXNT is worth more XNT over time. ### Example The numbers are made up to show the mechanics; they are not a rate forecast. 1. You stake 100 XNT when rate is 1.000 2. You receive 100 pXNT 3. Later, the rate is 1.050 4. Your 100 pXNT = 105 XNT 5. You earned 5 XNT in rewards The exchange rate only goes up (or stays flat). It never decreases under normal conditions. ## Staking XNT ### Via Telegram 1. Use `/earn` or tap "Earn" in the menu 2. Select "Liquid Staking" 3. Enter the amount of XNT to stake 4. Confirm the transaction ### Via Dashboard 1. Open **Earn** and pick **Liquid Staking** 2. Enter stake amount 3. Review the pXNT you'll receive 4. Click "Stake" and confirm ### What You'll See * **Amount to Stake:** Your XNT input * **pXNT to Receive:** Based on current exchange rate * **Current Rate:** The pXNT:XNT exchange rate * **Estimated APY:** Current yield estimate ## Unstaking pXNT ### Via Telegram 1. Go to "Earn" → "Liquid Staking" 2. Tap "Unstake" 3. Enter pXNT amount (or "Max") 4. Confirm the transaction ### Via Dashboard 1. Open **Earn** and pick **Liquid Staking** 2. Click "Unstake" 3. Enter amount and confirm ### Instant Liquidity Unlike validator staking, there's no waiting period. Your XNT is paid from the pool's reserve and is available immediately after the transaction confirms. ## Viewing Your Position Check your liquid staking position anytime: **Telegram:** ``` /mystakes ``` **Dashboard:** **Earn → Liquid Staking**, your position You'll see: * pXNT balance * Current XNT value * Rewards earned * Entry exchange rate * Current exchange rate ## APY Rewards come from the validator rewards earned by the pool's stake. The current rate is shown in the Liquid Staking section of the Earn Hub. APY is variable and depends on network conditions. Past performance doesn't guarantee future returns. ## Pool Fee The pool's fees are set on-chain in the pool account, and the current pool fee is shown on the Earn page. Fees cover: * Pool operations * Validator management * Smart contract maintenance ## Risks ### Smart Contract Risk The liquid staking pool relies on smart contracts. Bugs could potentially affect funds. ### Slashing Risk If underlying validators misbehave, staked funds could be slashed. ### Exchange Rate Risk In extreme scenarios (mass slashing), the exchange rate could decrease. This is rare but possible. ### Liquidity Risk Instant unstaking is paid from the pool's reserve. In high-demand unstaking periods, the reserve can run low and there may be temporary delays. Only stake what you can afford to lose. ## pXNT in DeFi Since pXNT is a standard token, you can use it in any DeFi protocol that accepts it — for example, providing pXNT liquidity in a DEX pool. Using pXNT in other protocols adds additional smart contract risk. DYOR before depositing. ## Comparing to Validator Staking | Feature | Liquid Staking | Validator Staking | | ---------- | ----------------- | ----------------- | | APY | Variable | Variable | | Liquidity | Instant | Epoch-locked | | Minimum | 0.01 XNT | 0.01 XNT | | Complexity | Simple | Choose validator | | Token | pXNT | XNT | | Risk | Pool + validators | Single validator | ## FAQ All DeFi carries risk, including smart contract and validator risk. Only stake what you can afford to lose. Both rates vary with network conditions. Compare the current rates in the Earn Hub. Yes, there's no limit. Each transaction uses the current exchange rate. The exchange rate is shown in the Liquid Staking section of the Earn Hub. pXNT is a standard token. You can transfer it freely. Whoever holds pXNT can unstake it. ## Commands Reference | Command | Description | | ----------- | -------------------------- | | `/earn` | Open Earn Hub | | `/stake` | Open staking menu | | `/mystakes` | View all staking positions | --- # Orders & Positions URL: /docs/pro/orders > Manage limit orders and track your token positions # Orders & Positions Track your holdings and manage automated orders to maximize profits and minimize losses. ## Viewing Positions ### All Positions ``` /positions ``` Displays the tokens you hold in your active wallet: ``` Your Positions Token A (7xKX...abc) Balance: 1,000,000 Value: $500 Entry: $0.00040 Current: $0.00050 PnL: +25% (+$100) Token B (9fQ2...xyz) Balance: 500,000 Value: $200 Entry: $0.00050 Current: $0.00040 PnL: -20% (-$50) ``` ### Position Details Click on any position for detailed view: * Full token info * Price chart * Trade history * Active orders ### Dashboard View The dashboard Portfolio page shows: * Sortable position table * Active orders * Trade history (with CSV export) ## Order Types ### Take Profit (TP) Automatically sell when price rises to target. **Create TP Order:** ``` /takeprofit [amount] ``` **Example:** Sell 50% when price hits $1.00 ``` /takeprofit 7xKXtg...abc 1.00 50% ``` Leave out the amount to sell everything. ### Stop Loss (SL) Automatically sell when price drops to limit losses. **Create SL Order:** ``` /stoploss [amount] ``` **Example:** Sell 100% if price drops to $0.30 ``` /stoploss 7xKXtg...abc 0.30 ``` ### Trailing Stop Dynamic stop loss that follows price upward. **Create Trailing Stop:** ``` /trailing [amount] ``` **Example:** 15% trailing stop ``` /trailing 7xKXtg...abc 15 ``` **How it works:** * Price rises from $1.00 to $2.00 * Stop triggers at $1.70 (15% below peak) * If price continues to $3.00 * Stop moves to $2.55 (15% below new peak) ### DCA Orders Dollar Cost Average into positions over time. **Create DCA Order:** 1. On the web, open Trade and pick **DCA**; in Telegram, open **Trading → DCA** or use `/dca_start ` 2. Select token 3. Configure: * Amount per buy * Number of buys * Interval (for example 1h or 1d) 4. Activate ## Managing Orders ### View All Orders ``` /orders ``` Lists all active orders: ``` Active Orders #1 Take Profit Token: ABC (7xKX...abc) Trigger: $1.00 Sell: 50% Status: Active #2 Stop Loss Token: ABC (7xKX...abc) Trigger: $0.30 Sell: 100% Status: Active ``` ### Edit Order Open the order from `/orders` and tap **Edit Order**. Modify order parameters: * Trigger price * Amount * Slippage ### Cancel Order ``` /cancelorder ``` Or tap **Cancel Order** on the order. Removes the order without executing. ## Order Strategies ### Basic Protection For every position, set: 1. **Take Profit** at 2-3x entry 2. **Stop Loss** at -30% to -50% Example setup for $100 position: * TP: Sell 50% at 2x ($200 value) * TP: Sell remaining at 3x ($300 value) * SL: Sell 100% at 0.5x ($50 value) ### Scaling Out Take profits in stages: ``` TP1: Sell 25% at +50% TP2: Sell 25% at +100% TP3: Sell 25% at +200% TP4: Trailing stop for rest ``` ### Risk-Adjusted Stops Tighter stops for larger positions: | Position Size | Stop Loss | | ------------------ | --------- | | Small (under $100) | -50% | | Medium ($100-$500) | -30% | | Large (over $500) | -20% | ### Breakeven Stop After significant gains, move stop to breakeven: 1. Buy at $1.00 2. Price rises to $1.50 3. Move SL to $1.00 (breakeven) 4. Risk-free from here ## Position Management ### Averaging Down Add to losing positions strategically: 1. Initial buy at $1.00 2. Price drops to $0.50 3. Buy same amount at $0.50 4. New average: $0.75 **Caution:** Only average down on conviction plays. ### Taking Partial Profits Don't be all-or-nothing: * Sell 25% to recover initial * Let rest ride with trailing stop * Reduces stress and locks gains ### Cutting Losses Know when to exit: * Stop hit? Execute immediately * Don't move stops to avoid loss * Accept small losses to avoid large ones ## Position Tracking ### Performance Metrics Track per position: * Entry price * Current price * Unrealized PnL * Realized PnL * Hold duration ### Trade History View your complete history on the dashboard **Portfolio → Trades** tab. It shows all buys and sells with: * Date/time * Price * Amount * PnL ### Export Data Download trade history from dashboard: * CSV format * Tax reporting ready * Full transaction details ## Portfolio View ### Total Value * Current total value * 24h change ### Performance Overall portfolio metrics: * Total P\&L * Win rate ## Alerts & Notifications ### Price Alerts Set alerts without orders from the dashboard **Watchlist**, and turn on price-alert notifications in Settings. ### Order Notifications Receive alerts when: * Order is triggered * Order is filled * Order fails ### Configure Notifications Set notification preferences with `/notifications` in Telegram or in the dashboard Settings: * Trade notifications * Order fill notifications * Copy trade notifications * Price alerts ## Best Practices 1. **Always use stops** - No position without protection 2. **Set orders immediately** - Don't wait to set TP/SL 3. **Review weekly** - Adjust orders as needed 4. **Don't overtrade** - Quality over quantity 5. **Track everything** - Use history for improvement --- # Referral Program URL: /docs/pro/referrals > Earn rewards by inviting friends to trade on FortiSwap Pro # Referral Program Earn passive income by sharing FortiSwap Pro with friends and fellow traders. When your referrals trade, you earn a percentage of their trading fees. ## How It Works ### Get Your Referral Code Every user gets a unique 8-character referral code. Find yours in the Telegram bot using `/referral` or on the Dashboard under **Earn → Referrals**. ### Share Your Link Share your personalized referral link with friends: ``` https://t.me/fortiswap_bot?start=ref_YOURCODE ``` ### Earn Commissions When your referrals trade, you automatically earn a percentage of their trading fees. Commissions are tracked in real-time. ### Claim Rewards Once your earnings reach the minimum threshold, claim your XNT rewards directly to your wallet. ## Commission Structure ### Commission Rates Your commission rate starts at **25%** of your referrals' trading fees and steps down every 30 days from when each referral joined: | Period | Commission Rate | | ---------- | --------------- | | Days 1–30 | 25% | | Days 31–60 | 20% | | Days 61–90 | 15% | | Day 91+ | 10% | The commission decay encourages active referral growth. Keep inviting new users to maintain higher earnings! ### Example Earnings Swaps carry a 0.25% fee. If your referral makes a 10 XNT swap, the fee is 0.025 XNT: * **Days 1–30**: You earn 25% of 0.025 XNT = **0.00625 XNT** * **Day 91+**: You earn 10% of 0.025 XNT = **0.0025 XNT** ## Commission Lock Period To ensure the integrity of the referral program, all earned commissions are subject to a **7-day lock period**: * Commissions become claimable 7 days after they are earned * This prevents abuse from wash trading or fraudulent activity * You can view your locked vs. claimable balance in the Referrals dashboard Commissions may be revoked if the underlying trade is reversed or flagged for suspicious activity. ## Using the Referral System ### Via Telegram Bot **View Your Referral Info:** ``` /referral ``` This displays your referral code, shareable link, and current stats. **View Detailed Stats:** ``` /referralstats ``` Shows total referrals, earnings breakdown, and commission history. **Claim Your Rewards:** ``` /claim ``` Initiates a payout of your claimable commission to your default wallet. ### Via Web Dashboard 1. Log into the [FortiSwap Pro Dashboard](https://pro.fortiblox.com) 2. Open **Earn** and pick the **Referrals** tab 3. View your stats, copy your referral link, and claim rewards ## Applying a Referral Code If someone shared their code with you: ### Via Telegram Open their referral link. This works for new users and for existing users who don't have a referrer yet. You can also use the bot's apply feature in the Referrals menu. ### Via Dashboard 1. Open **Earn → Referrals** 2. Find the "Have a Referral Code?" section 3. Enter the 8-character code and click Apply You can only apply a referral code once. After applying, you cannot change your referrer. ## Referral Rules ### Eligibility * All FortiSwap Pro users are automatically enrolled in the referral program * Your referral code is generated when you first use the bot * There is no limit to how many people you can refer ### Restrictions * You cannot use your own referral code, and two users cannot refer each other * Each user can only have one referrer (cannot be changed) * Referral relationships are permanent once established ### Commission Eligibility * Commissions are only earned on legitimate trades * Wash trading (trading between your own accounts) is prohibited * Suspicious activity may result in commission forfeiture and account suspension ### Banned/Suspended Referrers * If a referrer's account is banned, their referral code becomes invalid * Existing referral relationships remain, but no new referrals can use the code * Pending commissions may be frozen pending review ## Leaderboard Top referrers can be featured on a referral leaderboard in the dashboard. ## Notifications You'll receive a notification when someone uses your referral code (new referral). Check `/referralstats` or the Referrals tab for commissions, locked vs. claimable balances, and payouts. ## Claiming Rewards ### Minimum Claim Amount The minimum claim in Telegram is **0.01 XNT**. Smaller amounts will continue to accumulate until they reach the threshold. ### Payout Process 1. Click "Claim" in the Dashboard or use `/claim` in Telegram 2. Confirm the payout amount and destination wallet 3. The payout is queued for processing 4. Check the payout history on the Referrals tab ### Payout Limits * Maximum single claim: **1,000 XNT** * For larger amounts, contact [Discord support](https://discord.gg/3THDDnSkZk) ## FAQ Commission rates decay over time as part of the program structure. This encourages continuous referral activity. Your rate starts at 25% and steps down every 30 days until reaching the 10% floor. Possible reasons: * Your claimable balance is below 0.01 XNT * Your commissions are still in the 7-day lock period * You don't have a wallet set up * There's already a pending payout being processed No, referral relationships are permanent. Once you apply a referral code, it cannot be changed. Use `/referralstats` in Telegram or check the Referrals page in the Dashboard. Your referred users are listed with their join date and activity status. You only earn commissions on actual trades. If your referral becomes inactive, you won't earn from them, but the relationship remains. They can return and trade at any time. Not on swaps today: every swap pays the same 0.25% fee, charged by the on-chain router. Check current promotions in the Dashboard. ## Tips for Success 1. **Share in Trading Communities**: Post your link in crypto Discord servers, Telegram groups, and forums 2. **Create Content**: Make tutorials about FortiSwap Pro and include your referral link 3. **Engage Your Network**: Personal recommendations convert better than mass sharing 4. **Help Your Referrals**: The more they trade, the more you earn - help them succeed! --- # Settings URL: /docs/pro/settings > Configure FortiSwap Pro to match your trading style # Settings Customize FortiSwap Pro to fit your trading preferences and workflow. ## Accessing Settings **Via Telegram:** ``` /settings ``` Or tap **More → Settings**. **Via Dashboard:** Click the gear icon or open **Settings** from the All features menu. ## Trading Settings ### Default Slippage Set the default slippage tolerance for trades. The Telegram menu offers: | Setting | Description | | --------------- | ------------------------------------------ | | 1% | Standard for liquid tokens | | 2% | Light volatility | | 5% | Higher volatility | | 10% / 15% / 20% | New or thin tokens | | Custom | `/slippage `, from 0.1% to 50% | **Recommendation:** Start with 1-3% and adjust based on experience. On the dashboard, set **Max slippage** in the swap settings or the default in **Settings → Trading**. ### Priority Fee Choose how much priority fee your transactions pay: | Mode | Speed | Cost | | ---------- | ------- | ---------------------------------- | | safe | Normal | Lowest | | fast | Quick | Medium | | degenerate | Fastest | Highest (needs extra confirmation) | Check your mode with `/priority_fee_mode`; change it with `/priority_fee_mode_set safe|fast|degenerate`. On the dashboard, set the **Priority fee** in the swap settings and the **Default Gas Multiplier** in Settings. ### MEV Protection Toggle MEV protection with `/mev` in Telegram, or **MEV protection** in the dashboard swap settings. ### Quick Buy Amounts Preset buy amounts for fast trading (the defaults): ``` Quick Buy 1: 0.1 XNT Quick Buy 2: 0.5 XNT Quick Buy 3: 1.0 XNT Quick Buy 4: 5.0 XNT ``` Customize: `/presets` in Telegram, or **Quick-Action Button Presets** in the dashboard Settings. Set your default buy amount with **Buy Amt** in `/settings`. ### Quick Sell Percentages Preset sell percentages (the defaults): ``` Quick Sell 1: 25% Quick Sell 2: 50% Quick Sell 3: 75% Quick Sell 4: 100% ``` ### Auto Approve **Auto Approve** in `/settings` (and **Auto-approve Tokens** on the dashboard) automatically approves tokens for trading. ## Interface Settings ### Clean Chat Mode Edit previous messages instead of sending new ones: toggle **Clean Chat** in `/settings`. Benefits: * Less chat clutter * Cleaner conversation * Easier to track ### Hide Dust and Scam Tokens Toggle **Hide Dust** and **Hide Scam** in `/settings` to keep tiny balances and known scam tokens out of your lists. ### Theme On the dashboard, switch between light and dark mode from the top bar. ## Notification Settings ### Trade Notifications Open `/notifications` in Telegram, or **Settings → Notifications** on the dashboard: | Notification | Options | | ------------ | ------- | | Trades | On/Off | | Price Alerts | On/Off | | Copy Trades | On/Off | | Order Fills | On/Off | ## Security Settings ### Two-Factor Auth Tap **🔐 Two-Factor Auth** in `/settings` to add a second confirmation step for sensitive actions. ### Withdrawal Confirmation Every withdrawal asks you to confirm before it is sent. ### Session Management On the dashboard, **Settings → Security** sets a session timeout (auto logout after inactivity), and **Settings → Account** shows the sign-in accounts linked to your profile. ## Wallet Settings ### Default Wallet Set which wallet is active by default: ``` /setdefault ``` ### Wallet Names Name a wallet when you create it (`/newwallet `) or rename it from the wallet menu. On the dashboard, wallets are listed under **Settings → Wallets**. ## Settings by Strategy ### Scalping Setup For quick, frequent trades: ``` Slippage: 1% Priority fee: fast Clean Chat: On Quick Buy: 0.1, 0.25, 0.5, 1.0 ``` ### Swing Trading Setup For longer holds: ``` Slippage: 2-5% Priority fee: safe Clean Chat: Off Quick Buy: 1.0, 2.5, 5.0, 10.0 ``` ### Sniping Setup For new token launches: ``` Slippage: 10%+ Priority fee: fast or degenerate Dedicated wallet: Wallet 3 ``` ### Copy Trading Setup For passive following: ``` Priority fee: fast Notifications: Copy Trades on Dedicated wallet: Wallet 2 ``` ## Troubleshooting Settings ### Settings Not Saving * Check internet connection * Try again after refresh * Contact [Discord support](https://discord.gg/3THDDnSkZk) if persistent ### Settings Not Applying * Verify setting value is valid * Check for conflicting settings * Reset and reconfigure ### Can't Access Settings * Try `/settings` command * Clear chat and retry * Use dashboard instead --- # Sniping (Auto Sniper + Launchpad Sniper) URL: /docs/pro/sniping > Rule-based auto-sniping of new X1 pools and launchpad launches, with anti-rug guards and auto-exit configuration # Sniping FortiSwap Pro's sniping stack lets you buy new tokens the moment they list — either the second liquidity is added to a new AMM pool, or while a launchpad token is on its bonding curve and when it graduates. This guide covers both flavors and the rules that drive them. Sniping is a genuinely advanced feature. It is highly competitive, has a high failure rate, and can lose money quickly. Start with tiny sizes, and use the launchpad sniper's observe-only mode before scaling up. ## The sniper paths FortiSwap Pro exposes three user-facing sniper modes: 1. **Auto Buy Rules** — rule-based auto-sniper for freshly-created XDEX pools. Fires when a new pool is discovered and it matches all your rule filters. 2. **Snipe a Token** — one-shot sniper for a specific token address you already know about. Arm it, and it buys when the token's liquidity appears. 3. **Launchpad Sniper** — rules for launchpad tokens, before graduation (on the bonding curve), after graduation, or both. In Telegram this is the primary sniper. ## Getting started ### From the dashboard Open **Automations → Snipers**. The **Sniper** tab has **Arm Sniper** (one token) and **Auto Buy Rules**; the **Launchpad Sniper** tab has your launchpad rules. ### From Telegram ``` /snipe [slippage_bps] ``` Buys a specific token. Send `/snipe` alone for the interactive flow, `/snipe_launchpad` for your launchpad sniper status, and `/autosnipe` to turn the auto-sniper on or off. ## Rules for "Auto Buy Rules" Each rule is a filter set. The sniper watches every new XDEX pool and only fires when *all* filters pass. | Filter | Description | | --------------------------------- | -------------------------------------------------------------- | | Amount (XNT) | XNT to spend per snipe | | Min / Max Liquidity | Skip pools with less (or more) liquidity than this | | Require Mint Authority Disabled | Only fire if no new tokens can be minted | | Require Freeze Authority Disabled | Only fire if token accounts can't be frozen | | Require LP Burned | Only fire if the liquidity is permanently locked | | Slippage % / Priority Fee | Execution settings | | Wallet | Which of your wallets to buy from | | Auto-Sell | Optional: sell a percentage of the position at a profit target | | Rule Label | Human name so you can find it later | In Telegram, `/addrule ` creates a rule and `/autorules` lists yours. ## Rules for the Launchpad Sniper | Setting | Description | | ----------------------- | --------------------------------------------------------- | | Launch Stages | Pre-Grad, Post-Grad, or both | | Max Trade (XNT) | XNT to spend per snipe | | Daily Cap (XNT) | Total spend per day | | Min Deployer Score | Skip tokens from deployers with a weak track record | | Preference Filters | Require socials, cap the share of brand-new buyer wallets | | Slippage / Priority Fee | Execution settings | | Observe-only | Record what the rule would have bought, without buying | Some anti-rug checks are always on for the launchpad sniper and can't be turned off: bundled-launch detection, a deployer reputation floor, mint and freeze authority checks, and a wallet reputation floor. Your own filters can only make a rule stricter. In Telegram, manage rules with `/launchpad_rules`, `/launchpad_rule_create`, `/launchpad_rule_pause`, `/launchpad_rule_resume` and `/launchpad_rule_delete`; `/launchpad_history` shows recent decisions. ## Anti-Rug guards Snipes are checked before the buy is submitted: * **Ownership scan** — check whether the token has an active mint/freeze authority. Optionally skip. * **LP check** — check whether the LP tokens have been burned. * **Liquidity bounds** — skip pools outside your liquidity range. * **Your anti-rug guard** — the guard you set with `/anti_rug_status` and `/anti_rug_severity` (strict, balanced or permissive) also applies. If a check fails, the attempt is logged as blocked. You can see the executions on the Sniper page. ## Speed Sniping is a latency race. Your priority fee decides how your transaction ranks: set it per rule, or pick a mode with `/priority_fee_mode` (`safe`, `fast` or `degenerate`). Confirmations usually take a few seconds, depending on the network. `/snipermode` switches the sniper's aggression preset. ## Auto-Exit configuration You almost never want a snipe to sit unmanaged. Auto Buy Rules can sell a set percentage of the position when it reaches a profit target. For more exits, attach your own: * **TP-Ladder** — Sell 25% at 2×, 25% at 5×, etc. Configurable rungs. * **Trailing Stop** — Follow the peak down by X%. * **Hard Stop-Loss** — Sell 100% if price drops to a trigger. See [Orders & Positions](/docs/pro/orders) and [Automations](/docs/pro/automations). ## Managing rules & snipes ### List active rules ``` /autorules /launchpad_rules ``` ### List queued snipes ``` /pendingsnipes ``` ### See your results ``` /sniperstats ``` Recent snipes and win rate for your account. ### Pause or delete a rule On the dashboard, use **Pause**, **Edit** or **Delete** on the rule. For launchpad rules in Telegram: ``` /launchpad_rule_pause /launchpad_rule_delete ``` Paused rules stop firing but keep their state. Deleted rules can't be recovered. ## Execution statuses | Status | Meaning | | ------- | ----------------------------- | | pending | Rule matched, buy in progress | | blocked | A check failed | | success | Buy confirmed, position open | | failed | The buy did not land | ## An honest note Sniping is for advanced users. The anti-rug checks are strong, but we're not going to tell you it's risk-free. If you're new to sniping, run a launchpad rule in observe-only mode for a week, or keep Amount to a fraction of an XNT, before increasing size. ## Common mistakes 1. **Filters too loose** — sniper fires on every new pool including scams. Fix: raise the minimum liquidity, require mint and freeze authority disabled. 2. **Filters too tight** — 0 fires in a week. Fix: relax the liquidity floor, or drop the LP-burned requirement. 3. **No auto-exit** — you snipe well and then forget to sell. Fix: always attach a TP-Ladder and a trailing stop. 4. **Priority fee too low** — you consistently get outbid. Fix: raise the priority fee for high-competition launches. 5. **Too much size per rule** — one bad token survives the guards and eats a full snipe. Fix: keep per-snipe size small and use a daily cap. ## Supported venues * **XDEX** — new XNT-paired pools * **Launchpad** — pre-graduation and post-graduation launches ## Related pages --- # Fees URL: /docs/pro/subscription-tiers > The 0.25% swap fee; paid tiers are paused # Fees Every swap on FortiSwap Pro pays the same 0.25% fee. Paid tiers are paused. ## The swap fee | Item | Value | | ------------ | ------------------------------------------------ | | Swap fee | **0.25%** (25 basis points) | | Charged by | The on-chain router, inside the swap transaction | | Taken in | The token you receive | | Network fees | Separate, paid to the network | Because the router charges the fee inside the same transaction as the swap, a swap that fails never costs you a swap fee. ### Example On a 100 XNT swap, the fee is 0.25 XNT. Part of the fee from referred users goes to their referrer (see the [Referral Program](/docs/pro/referrals)). The referred user still pays the same 0.25%. ## Paid tiers are paused Paid tiers are paused. All swaps pay a flat 0.25% fee, taken on-chain by the router. There is nothing to buy or upgrade: `/tier` and `/upgrade` in the bot show the fee and a button back to the menu. ## FAQ No. Every feature is available to everyone, and every swap pays the same 0.25% fee. No. The 0.25% swap fee is charged on-chain by the router. Network fees are separate and apply to everyone equally. Not on swaps today. Referred users pay the same 0.25%; part of it goes to their referrer. --- # Telegram Bot Guide URL: /docs/pro/telegram-bot > Complete guide to using the FortiSwap Pro Telegram bot # Telegram Bot Guide The FortiSwap Pro Telegram bot is your primary interface for trading on the X1 blockchain. This guide covers all available commands and features. ## Accessing the Bot **Bot Link**: [t.me/fortiswap\_bot](https://t.me/fortiswap_bot) ## Main Menu Type `/start` or `/menu` to access the main menu: ``` 🔥 Trending Buy | Sell | Swap Send | Bridge Portfolio | 💰 Earn Trading | 🎁 Referral More | Support ``` ### Menu Buttons | Button | Description | | ----------- | -------------------------------------------- | | 🔥 Trending | View curated hot tokens with one-tap buying | | Buy | Purchase tokens | | Sell | Sell your holdings | | Swap | Swap any token for any other | | Send | Transfer tokens to another wallet | | Bridge | Move USDC between X1 and Solana | | Portfolio | Access wallet, positions, orders, copy trade | | 💰 Earn | Staking and XP rewards hub | | Trading | Advanced trading features | | 🎁 Referral | Your referral code and stats | | More | Settings, tools, and help | | Support | Links to Discord support and the community | ## Submenus ### Portfolio Menu Access via the "Portfolio" button: * **Wallet** - View balances and addresses * **Positions** - Current token holdings * **Orders** - Active limit orders * **Copy Trade** - Copied wallet settings ### Trading Menu Access via the "Trading" button: * **Snipe** - Token sniping setup * **DCA** - Dollar cost averaging * **Limit Orders** - Set TP/SL orders * **Strategies** - Grid, Martingale, Trend Following, Rebalancing ### More Menu Access via the "More" button: * **Settings** - Bot configuration * **Tools** - Wallet watchlist, whale alerts, token socials, unwrap XNT, refresh balances, close dust accounts * **Help** - Command reference XP Rewards live in the **💰 Earn** menu. ## Trading Commands ### Buying Tokens **Method 1: Paste Contract Address** Simply paste a token contract address and the bot will prompt you to buy. **Method 2: Buy Command** ``` /buy ``` The bot asks for the token contract address, then shows the amount buttons (0.1, 0.5, 1 and 5 XNT, or a custom amount). **Method 3: Trending** Tap "Trending" and tap any token to buy instantly. ### Selling Tokens ``` /sell ``` This displays the tokens in your active wallet. Select a token and choose: * Sell 25% * Sell 50% * Sell 75% * Sell 100% * Custom % ### Emergency Exit ``` /nuke ``` Sells every open position. ## Wallet Commands ### View Wallet ``` /wallet ``` Options: * View balances * Deposit / Withdraw * Export key * Create wallet (up to 10) * Import wallet * Select wallet * Remove wallet Shortcuts: `/newwallet`, `/importwallet`, `/wallets`, `/setdefault`, `/deletewallet`, `/export`. ### Check Balance ``` /balance ``` Shows the XNT balance of each of your wallets. ### Deposit ``` /deposit ``` Displays your wallet address for deposits. ### Withdraw ``` /withdraw
``` Example: `/withdraw 7xKXtg...abc 5` The bot asks you to confirm before it sends. ### Send Tokens ``` /send ``` Opens the send menu: pick XNT or a token, then enter the destination address and the amount. ## Order Commands ### View Orders ``` /orders ``` Lists all active orders. ### Take Profit Order ``` /takeprofit [amount] ``` ### Stop Loss Order ``` /stoploss [amount] ``` Leave out the amount to sell everything, or give a percentage such as `50%`. ### Trailing Stop ``` /trailing [amount] ``` ### Limit Orders ``` /limit /limit_buy /limit_sell ``` ### Cancel Order ``` /cancelorder ``` ## Copy Trading Commands ### View Copy Trades ``` /copy ``` ### Add Wallet to Copy ``` /copy [label] ``` `/track ` does the same. ### Remove Copied Wallet ``` /unfollow ``` `/untrack ` does the same. `/following` lists the wallets you follow. ### Copy Trading Settings ``` /copysettings ``` Configure: * Max amount per trade (`/copysettings max `) * Copy percentage (`/copysettings percent <1-100>`) * Slippage (`/copysettings slippage `) * Tokens to skip (`/copysettings skip `) Pause or resume all copying with `/pausecopy` and `/resumecopy`. ## Sniping Commands ### View Snipes ``` /snipe ``` ### Create Snipe ``` /snipe [slippage_bps] ``` ### Launchpad Sniper * `/snipe_launchpad` - Your launchpad sniper status and activity * `/launchpad_rules` - List your launchpad sniper rules * `/launchpad_rule_create` - Create a launchpad rule * `/autosnipe` - Toggle the auto-sniper for new launches ### Snipe Settings ``` /snipesettings ``` ## Earn Commands ### Open Earn Hub ``` /earn ``` Access liquid staking, validator staking, and XP rewards. ### Staking ``` /stake ``` Stake XNT for rewards via liquid staking or validators. ### View Stakes ``` /mystakes ``` View all your staking positions and rewards. ### Browse Validators ``` /validators ``` Browse and compare X1 validators for staking. ## Referral Commands ### View Referral Info ``` /referral ``` Shows your referral code, link, and stats. ### View Detailed Stats ``` /referralstats ``` Detailed breakdown of referrals and commissions. ### Claim Rewards ``` /claim ``` Claim your pending referral commissions. ### View the Fee ``` /tier ``` Shows the swap fee. Paid tiers are paused (see [Fees](/docs/pro/subscription-tiers)). ### Upgrade ``` /upgrade ``` Paid tiers are paused, so there is nothing to upgrade; it shows the same fee message as `/tier`. ## Settings Commands ### View Settings ``` /settings ``` ### Configure Options * **Slippage**: Default slippage tolerance (`/slippage `) * **Buy Amount**: Default buy amount * **Priority fee**: `safe`, `fast` or `degenerate` (`/priority_fee_mode`) * **Notifications**: Trade, price, copy-trade and order-fill alerts (`/notifications`) * **Clean Chat**: Edit vs new messages * **Two-Factor Auth**: Extra confirmation for sensitive actions ## Utility Commands | Command | Description | | ------------- | ---------------------------------------- | | `/help` | Show help menu | | `/commands` | Full command reference | | `/faq` | Common questions | | `/presets` | Edit your buy and sell buttons | | `/whalealert` | Whale transfer alerts | | `/stuck` | Inspect and unstick pending transactions | | `/web ` | Approve a dashboard sign-in code | | `/start` | Reset bot / main menu | | `/menu` | Show main menu | ## Complete Command Reference Send `/commands` in the bot for every command. The most used ones: ### Trading | Command | Description | | --------- | --------------------------------- | | `/buy` | Buy tokens | | `/sell` | Sell tokens | | `/send` | Send tokens to address | | `/swap` | Swap any token for any other | | `/bridge` | Bridge USDC between X1 and Solana | ### Portfolio | Command | Description | | ------------ | ------------------- | | `/wallet` | Wallet management | | `/balance` | Check balances | | `/positions` | View holdings | | `/deposit` | Get deposit address | | `/withdraw` | Withdraw funds | ### Orders | Command | Description | | -------------- | ------------------ | | `/orders` | View active orders | | `/limit` | Limit-order menu | | `/takeprofit` | Take profit order | | `/stoploss` | Stop loss order | | `/trailing` | Trailing stop | | `/cancelorder` | Cancel order | | `/dca` | DCA order setup | | `/tp_create` | Take-profit ladder | ### Copy Trading | Command | Description | | -------------------- | ----------------------- | | `/copy` | Copy trade menu | | `/copy ` | Add wallet to copy | | `/unfollow ` | Remove copied wallet | | `/following` | List wallets you follow | ### Sniping | Command | Description | | --------------------- | ---------------- | | `/snipe` | Snipe menu | | `/snipe ` | Create snipe | | `/snipe_launchpad` | Launchpad sniper | ### Earning | Command | Description | | ------------- | ----------------- | | `/earn` | Earn hub menu | | `/stake` | Stake XNT | | `/mystakes` | View stakes | | `/validators` | Browse validators | ### Referrals | Command | Description | | ---------------- | --------------------- | | `/referral` | Referral info | | `/referralstats` | Detailed stats | | `/claim` | Claim rewards | | `/tier` | View the swap fee | | `/upgrade` | Paid tiers are paused | ### Settings & Help | Command | Description | | ----------- | --------------------------------------- | | `/settings` | Bot settings | | `/help` | Help menu | | `/support` | Get a link to FortiBlox Discord support | ## Keyboard Shortcuts The bot uses inline keyboards for quick actions: * **Refresh** - Update displayed data * **Back** - Return to previous menu * **Close** - Close current view ## Tips for Best Experience 1. **Pin the bot** - Pin the chat for quick access 2. **Use Trending** - Discover and buy hot tokens instantly 3. **Set default amounts** - Speed up trading in Settings 4. **Enable notifications** - Stay informed on order fills 5. **Use submenus** - Portfolio and Trading organize features logically ## Troubleshooting ### Bot Not Responding * Check your internet connection * Try `/start` to reset * Bot may be under maintenance ### Transaction Failed * Insufficient balance * Slippage too low * Token may have transfer restrictions ### Wallet Issues * Ensure you've backed up your private key * Check that the correct wallet is selected --- # TokenIntel Panel URL: /docs/pro/token-intel > The 13-panel structured deep-dive on any XNT-paired token # TokenIntel Panel The TokenIntel panel is a structured 13-panel matrix that consolidates what FortiSwap Pro knows about a token into one page. Open it at `pro.fortiblox.com/tokens//intel`. ## The 13 panels Each panel is scoped to a specific question, and shows the fact behind its signal (there is no overall token score): 1. **Signals** — six signals, each with the on-chain fact behind it 2. **Smart Money Holders** — share of known holders that are Smart Money 3. **Market Regime** — the token's current market regime 4. **Trade Pressure (5m)** — recent buy vs sell pressure 5. **Pool Liquidity** — current pool liquidity in XNT 6. **Trade Velocity (24h)** — 24h volume and trade count 7. **Holder Δ (24h)** — change in holder count over 24 hours 8. **Synthesis** — a one-line summary of the panels above 9. **Source Health** — which data sources are fresh or degraded 10. **Synthesis Age** — when the summary was computed 11. **Token Identity** — the token address 12. **What this means for your trade** — the practical takeaway 13. **Risk Flags** — degraded data and missing signals ## When to use it * **Before a sniper rule fires** — open TokenIntel on a target to sanity-check filters * **Before a manual buy on a new token** — check liquidity, holder growth and risk flags * **When Forti flags a Smart Money buy** — see how much of the holder base is Smart Money ## Data freshness * **Source Health** and **Synthesis Age** tell you how fresh each part of the panel is * If a data source is degraded, it shows up in **Risk Flags** ## Related pages --- # Trading Guide URL: /docs/pro/trading > Learn how to trade effectively with FortiSwap Pro # Trading Guide Master trading on the X1 blockchain with FortiSwap Pro. This guide covers everything from basic swaps to advanced order types. ## What's changed recently If you've used FortiSwap Pro before and are coming back: * **Faster buys.** Confirmations usually take a few seconds, depending on the network. * **Atomic fee + trade.** Swaps go through the on-chain router, which charges the 0.25% fee inside the same transaction, so you can no longer get charged a fee for a trade that ultimately reverted. * **Anti-rug checks.** Buys can run through the anti-rug guard (`/anti_rug_status`, `/anti_rug_severity strict|balanced|permissive`). See [Charts & Market Intel](/docs/pro/charts). * **Token security strip.** Every token chart shows the facts behind a token's risk: LP burned share, top-10 holder share, and whether mint and freeze authority are still active. ## Basic Trading ### Buying Tokens **Via Telegram:** 1. Paste a token contract address 2. Select buy amount 3. Confirm the transaction **Via Dashboard:** 1. Navigate to Trade 2. Enter token address 3. Set amount and parameters 4. Click Buy ### Selling Tokens **Via Telegram:** ``` /sell ``` Select your position and choose sell percentage. **Via Dashboard:** 1. Go to Portfolio 2. Click on the token 3. Choose sell amount 4. Confirm transaction ## Understanding Slippage Slippage is the difference between expected and executed price. ### Recommended Slippage Settings | Market Condition | Slippage | | --------------------- | --------- | | Stable/High Liquidity | 0.5% - 1% | | Moderate Volatility | 1% - 3% | | High Volatility | 3% - 5% | | New/Low Liquidity | 5% - 15% | Set your default in Telegram with `/slippage ` (0.1–50%) or the Settings menu, and on the web in the swap settings (**Max slippage**). ## Priority Fees ### Priority Fee Modes In Telegram, `/priority_fee_mode` shows your current mode and `/priority_fee_mode_set` changes it: | Mode | Use Case | | ---------- | -------------------------------------------------------------- | | safe | Normal trading | | fast | Quick execution | | degenerate | Time-sensitive trades (highest fees; needs extra confirmation) | On the web, set the **Priority fee** in the swap settings. ### Priority Fee Tips * Use **fast** during high volatility * **safe** is fine for most trades ## Limit Orders ### Take Profit (TP) Automatically sell when price reaches your target. ``` /takeprofit [amount] ``` Example: Sell 50% when token reaches $1.00 ``` /takeprofit 7xKXtg...abc 1.00 50% ``` ### Stop Loss (SL) Protect against losses by selling if price drops. ``` /stoploss [amount] ``` Example: Sell everything if price drops to $0.50 ``` /stoploss 7xKXtg...abc 0.50 ``` ### Trailing Stop Dynamic stop loss that follows the price up. ``` /trailing [amount] ``` Example: 10% trailing stop ``` /trailing 7xKXtg...abc 10 ``` If token goes from $1 to $2, stop triggers at $1.80 (10% below peak). ## DCA (Dollar Cost Averaging) Spread purchases over time to reduce volatility impact. ### Setting Up DCA 1. On the web, open Trade and pick **DCA**; in Telegram, open **Trading → DCA** or use `/dca_start ` 2. Select token 3. Set the amount per buy 4. Choose interval (for example 1h or 1d) 5. Set number of buys 6. Activate ### DCA Benefits * Reduces timing risk * Smooths entry price * Automated execution * Good for accumulation ## Trading Strategies ### Momentum Trading 1. Identify trending tokens 2. Enter on pullbacks 3. Set tight stop losses 4. Take profit in stages ### Swing Trading 1. Identify support/resistance 2. Buy at support 3. Sell at resistance 4. Use wider stops ### Scalping 1. Trade small timeframes 2. Take quick profits 3. Use tight stops 4. High frequency ## Risk Management ### Position Sizing Never risk more than you can afford to lose. **Suggested Guidelines:** * No single trade > 5% of portfolio * Total exposure \< 20% in high-risk tokens * Keep reserves for opportunities ### Using Stop Losses Always use stop losses: * Set before entering trade * Don't move to increase loss * Consider volatility when setting ### Taking Profits Don't be greedy: * Take partial profits at targets * Let winners run with trailing stops * Lock in gains regularly ## Advanced Techniques ### Scaling In/Out Instead of one entry/exit, scale positions: **Scaling In:** * 33% at first target * 33% on confirmation * 33% on dip **Scaling Out:** * 25% at +50% * 25% at +100% * 50% trailing stop ### Portfolio Rebalancing Periodically rebalance: 1. Review positions monthly 2. Trim winners that are overweight 3. Add to convictions 4. Remove dead positions ## Common Mistakes to Avoid 1. **FOMO buying** - Don't chase pumps 2. **No stop loss** - Always protect downside 3. **Overtrading** - Quality over quantity 4. **Ignoring fees** - Account for the 0.25% swap fee, network fees and slippage 5. **Emotional trading** - Stick to your plan --- # Trending Tokens URL: /docs/pro/trending-tokens > Discover hot tokens and trade with one tap # Trending Tokens Stay on top of the X1 market with FortiSwap Pro's curated trending tokens list. See what's moving, catch momentum plays, and buy with a single tap. ## Accessing Trending * **Telegram:** Tap "Trending" in the main menu * **Dashboard:** Open **Discover** and pick the **Trending** tab ## How It Works The two lists are built differently: * **Telegram** — a curated list. The FortiSwap Pro team picks the tokens and their order; prices and 24h change are live. * **Dashboard** — ranked automatically by 24h volume, liquidity and trade count. The Telegram list is curated, so not every token appears there. The dashboard ranking covers every listed token that meets the basic quality filters. ## Reading the Trending List Each token in the list displays: | Element | Meaning | | ------------- | ----------------------------- | | Token Symbol | The ticker (e.g., PEPE, BONK) | | Current Price | Live price | | 24h Change | Price change with indicator | ### Price Change Indicators * **Green** - Price is up in the last 24 hours * **Red** - Price is down in the last 24 hours * **Percentage** - Exact change amount Example display: ``` PEPE 0.00001234 +15.2% BONK 0.00000567 -3.4% ``` ## One-Tap Trading The trending list is designed for fast action: ### View Trending Tap "Trending" to see the current hot tokens. ### Tap a Token Each token row is a button. Tap it to start buying. ### Confirm Purchase You'll be taken directly to the buy flow with the token pre-selected. No need to copy contract addresses or search - just tap and trade. ## Refreshing the List Markets move fast. Use the "Refresh" button to get the latest trending data. Trending status can change quickly. Always do your own research before trading. Past performance doesn't guarantee future results. ## Trending vs. Your Watchlist | Feature | Trending | Watchlist | | ------- | ---------------------------------------------------- | ------------------------ | | Source | Curated (Telegram) or ranked by activity (Dashboard) | Your personal selections | | Updates | By the team (Telegram), automatic (Dashboard) | Manual add/remove | | Tokens | Market movers | Any token you choose | | Purpose | Discovery | Monitoring | Use trending for discovery, watchlists for tracking tokens you're already interested in. ## Tips for Using Trending 1. **Check Volume** - High volume trending is more reliable than low volume pumps 2. **Look at Charts** - Tap through to see full price history before buying 3. **Set Limits** - Use limit orders to catch better entries on trending tokens 4. **Don't Chase** - If a token has already pumped 100%, the easy gains may be over 5. **Diversify** - Don't put all your funds into one trending token ## FAQ In Telegram the token list is curated by the team, while prices and 24h change are live; use the refresh button to get the latest prices. On the dashboard the ranking follows market activity. The Telegram list is hand-picked, so most tokens are not on it. On the dashboard, use the other Discover tabs (All, Gainers, Losers, New Pairs) or search for the token. Currently, trending is on-demand only. Set price alerts on specific tokens if you want notifications. No. Telegram shows a curated list; the dashboard ranks tokens by 24h volume, liquidity and trade count. --- # Wallet Management URL: /docs/pro/wallet > Create, manage, and secure your trading wallets with FortiSwap Pro # Wallet Management FortiSwap Pro supports multiple wallets for flexible trading strategies. Learn how to create, manage, and secure your wallets. ## Who holds the keys * **Bot wallets** (created or imported in Telegram or on the dashboard) are held by FortiSwap Pro. Their private keys are stored encrypted on our servers so the bot can trade, snipe and copy for you without asking you to sign each time. You can export a key at any time. * **Connected browser wallets** (X1 Wallet, Backpack) and email or social sign-in wallets on the dashboard keep their own keys. You approve each transaction in the wallet. They are not available in Telegram. Sign in to the dashboard with a code from the bot (`/web `) and your bot wallets are available on the web too. ## Creating Wallets ### Your First Wallet When you first start the bot, it asks you to create or import a wallet: ``` /start ``` Tap **Create Wallet** in the wallet menu (or send `/newwallet [name]`). The bot displays: * Wallet address Back up the private key right away with `/export`. ### Additional Wallets Create up to 10 wallets: ``` /wallet ``` Select **Create Wallet** from the menu, or send `/newwallet [name]`. ### Wallet Labels New wallets are named "Wallet 1", "Wallet 2", and so on. You can identify them by: * Wallet name (pick your own when you create it, up to 50 characters, or rename it later) * Address (first and last characters) ## Viewing Balances ### All Wallets ``` /balance ``` Shows the XNT balance of each of your wallets: ``` Wallet Balances Wallet 1 (default): Address: 7xKX...abc Balance: 10.5 XNT Wallet 2: Address: 9fQ2...xyz Balance: 5.2 XNT ``` ### Single Wallet In the wallet menu, tap **View Balances** to see detailed balances including all tokens. ## Switching Wallets ### Via Command ``` /setdefault ``` Then pick the wallet. ### Quick Switch Tap **Select Wallet** in the wallet menu to switch instantly. ### Default Wallet Your active wallet is used for all trades. The default wallet is marked with **(default)** in lists. ## Depositing Funds ### Get Deposit Address ``` /deposit ``` Displays your active wallet's address for receiving funds. ### From Exchange 1. Copy your deposit address 2. Go to your exchange 3. Withdraw to your FortiSwap Pro address 4. Wait for confirmation ### From Another Wallet 1. Use your external wallet 2. Send to your FortiSwap Pro address 3. Transaction confirms automatically > **Note**: Only send X1 network tokens. Tokens from other networks may be lost. ## Withdrawing Funds ### Withdraw XNT ``` /withdraw ``` Example: ``` /withdraw 7xKXtg...abc 5.0 ``` ### Withdraw Tokens ``` /send ``` Pick **Send Token**, then the token, destination and amount. ### Withdrawal Confirmations Every withdrawal asks you to confirm before it is sent. Review the details carefully before confirming. ## Importing Wallets ### Import via Private Key ``` /importwallet ``` Or tap **Import Wallet** in the wallet menu. Then paste your private key when prompted; the bot deletes your message after reading it. > **Security Warning**: Only import keys from trusted sources. Never share your private key with anyone. ### Import Considerations * Imported wallets count toward your 10-wallet limit * You can export again at any time * Original wallet remains valid elsewhere ## Exporting Wallets ### Export Private Key ``` /export ``` Or tap **Export Key** in the wallet menu and pick a wallet. The key is sent in a message that is deleted automatically after 30 seconds. ### Why Export? * Backup your wallet * Use wallet in other apps * Transfer to new device ### Security Practices 1. Never screenshot private keys 2. Store in secure password manager 3. Consider hardware backup 4. Never share with anyone ## Wallet Security ### Private Key Safety Your private key is the master access to your wallet. Protect it: * **DO NOT** share with anyone * **DO NOT** enter on suspicious websites * **DO NOT** store in plain text files * **DO** use password managers * **DO** consider hardware backups ### Recognizing Scams FortiSwap Pro will **NEVER**: * Ask for your private key * DM you first * Request funds be sent somewhere * Require "verification" payments ### If Compromised If you suspect your key is compromised: 1. Immediately transfer funds to a new wallet 2. Create a fresh wallet in FortiSwap Pro 3. Do not use the compromised wallet 4. Report suspicious activity ## Multi-Wallet Strategies ### Strategy Separation Use different wallets for different purposes: | Wallet | Purpose | | -------- | --------------- | | Wallet 1 | Main trading | | Wallet 2 | Copy trading | | Wallet 3 | Sniping | | Wallet 4 | Long-term holds | | Wallet 5 | Testing | ### Benefits * Isolate risk * Track performance separately * Different settings per strategy * Clean organization ## Wallet Limits ### Current Limits * Maximum 10 bot wallets per account * No minimum balance required * No maximum balance ### Reaching Limits If you have 10 wallets and need more: 1. Export keys of unused wallets 2. Remove them from FortiSwap Pro (**Remove Wallet** or `/deletewallet`) 3. Create new wallets as needed ## Troubleshooting ### Wallet Not Showing * Refresh with `/wallet` * Check if correct account * Contact [Discord support](https://discord.gg/3THDDnSkZk) if persistent ### Balance Not Updating * Network may be congested * Try `/balance` again * Wait a few minutes for sync ### Transaction Stuck * Check `/stuck` to inspect pending transactions * Raise your priority fee (`/priority_fee_mode`) * Wait or contact [Discord support](https://discord.gg/3THDDnSkZk) --- # Components URL: /docs/test > Components ## Code Block ```js console.log('Hello World'); ``` ## Cards