# First Look at the Ecosystem
Explore Axiome Chain with AXM coin: wallets, staking, integration, and ecosystem tools. Your official guide to start building and earning.
## Development Directions
The Axiome Ecosystem is developing in three directions:
### **Axiome Chain**
A Layer 1 blockchain with the utility coin AXM, democratic network fees, detailed technical documentation, and smart contract support.
* [Axiome Chain](/developer-documentation/intro)
* [AXM Coin](/axiome-chain/axm-coin)
* [AXM Staking](/axiome-chain/axm-staking)
* [Partnership Program](/axiome-chain/partnership-program)
* [Community Pool](/axiome-chain/community-pool)
* [Axiome Premium](/axiome-chain/axiome-premium-subscription)
### **Axiome Trade**
One of the key products of the ecosystem, addressing three fundamental community needs: token issuance (Axiome Pump), token exchange (Axiome Swap), and perpetual derivatives trading (Axiome Futures):
{% embed url="" %}
* [Axiome Swap](/axiome-trade/axiome-swap)
* [Axiome Pump](/axiome-trade/axiome-pump)
* [Axiome Futures](/axiome-trade/axiome-futures)
### **Axiome Pay**
The first cryptocurrency card aggregator, offering the widest selection on the market and top-level service for users. Instant top-ups in USDT, card acceptance worldwide, and the highest spending limits. [Learn more](/axiome-pay/details-of-axiome-pay)
{% embed url="" %}
***
## Community Pool
The mission of Axiome is to build a large-scale ecosystem of modern DeFi solutions, through which AXM holders will always be able to increase and diversify their staking rewards.
The central element of AXM’s value is the Community Pool, whose income is generated from a variety of assets coming from different ecosystem solutions. **70%** of the pool’s income is distributed among AXM stakers, and **30%** among RET token holders.
{% hint style="success" %}
By staking AXM, as new projects appear within the ecosystem, your rewards will consist not only of AXM but also of the tokens of these projects! [Learn more](/axiome-chain/community-pool)
{% endhint %}
***
## Partnership Program
The introduction of the partnership program has become one of the key aspects in scaling the platform. This marketing model has proven that a great product combined with a generous reward system is the key to the rapid growth of the ecosystem. And over time, rewarded users become full-fledged experts, spreading the technology to the masses! [Learn more](/axiome-chain/partnership-program)
***
## Ways of generating profit
1. Share from the Community Pool. The most advanced “Share Revenue” model in the cryptocurrency market. Axiome ecosystem products generate profit into the common pool, and AXM and RET holders receive a share of the total pool profit.
2. Earn a share of network fees by delegating AXM.
3. Partnership reward. Development within the partnership program provides the opportunity to receive rewards from every delegation of invited users up to 14 levels deep.
4. Block validation. Sign blocks, mine new AXM for delegators, and earn your fees.
5. Provide liquidity to pools on Axiome Swap.
6. Coming Soon: Conduct large-scale presales on Axiome Pump.
7. Coming Soon: Trade perpetual derivatives on Axiome Futures with leverage up to x30.
***
## Tokenomics stabilization mechanisms
* AXM burning [mechanisms](/axiome-chain/axm-coin#burning-axm).
* Expansion of effective solutions within the ecosystem to enhance the utility of AXM and the value of the [Community Pool](/axiome-chain/community-pool) - in particular, Axiome Trade, Axiome Pay, and other partner products.
{% hint style="info" %}
**Important Links:**
🇬🇧 [Telegram in English](https://t.me/axiomeen)
🇷🇺 [Telegram на русском](https://t.me/axiomeru)
🇩🇪 [Telegram Auf Deutsch](https://t.me/axiomede)
[Twitter](https://twitter.com/axiome_pro)
[Axiome Pay ](https://axiomepay.com/en)- crypto cards
[Block Explorer](https://axiomechain.org/)
**Buy AXM:**
[On MEXC](https://www.mexc.com/exchange/AXM_USDT)
[On Biconomy](https://www.biconomy.com/exchange/AXM_USDT)
[On Tapbit](https://www.tapbit.com/spot/exchange/AXM_USDT?tab=USDT)
[P2P-bot](https://t.me/axiome_p2p_bot) (for users from Russia and Belarus)
[CoinMarketCap](https://coinmarketcap.com/currencies/axiome/)
[CoinGecko](https://www.coingecko.com/en/coins/axiome)
[LinkTree](https://linktr.ee/axiome_pro) - all links
{% endhint %}
# Steps for a new user
Quick start guide for beginners: create your Axiome wallet, get AXM, stake, join the partnership program, and explore the ecosystem in minutes.
### 1. [Download](/axiome-wallet-app) the Axiome Wallet mobile app
### 2. Create a new wallet
When registering, don’t forget to specify the nickname of the person who introduced you to Axiome. If you don’t have one, the system will assign you a random inviter.
{% hint style="warning" %}
Be sure to store your seed phrase in the most secure place!
{% endhint %}
### 3. Buy AXM
* [On MEXC](https://www.mexc.com/exchange/AXM_USDT)
* [On Biconomy](https://www.biconomy.com/exchange/AXM_USDT)
* [On Tapbit](https://www.tapbit.com/spot/exchange/AXM_USDT?tab=USDT)
* [P2P bot (for users from Russia and Belarus)](https://t.me/axiome_p2p_bot)
### 4. [Delegate](/axiome-chain/axm-staking) AXM
* Own a share of the Community Pool income based on the size of your AXM stake.
* Receive a share of all network fees.
### 5. Participate in the [partnership program](/axiome-chain/partnership-program)
* Earn RET partnership rewards from every delegation made by your invited users, up to 14 levels deep.
{% hint style="info" %}
You can find your invited partners and your progress in the status system in the [block explorer](https://axiomechain.org/). Just enter your nickname/address in the explorer’s search bar and go to your wallet page.
{% endhint %}
### 6. Swap tokens issued on Axiome Chain in just 2 clicks through [Axiome Swap](/axiome-trade/axiome-swap).
* A simplified version of Axiome Swap with exchange functionality is available directly inside the Axiome Wallet app under the “Swap” tab.
* The advanced version is available in the Axiome Trade [web interface](https://app.axiometrade.pro/), where you can also create liquidity pools, explore ecosystem tokens, and become a liquidity provider to earn trading fees.
### 7. Coming soon: Make creative tokenomics and conduct large-scale presales on [Axiome Pump](/axiome-trade/axiome-pump).
### 8. Coming soon: Trade perpetuals with leverage up to x30 on [Axiome Futures](/axiome-trade/axiome-futures).
# Axiome Wallet app
Get the Axiome Wallet app - access your AXM on iOS or Android, stake, send tokens, and explore Axiome Chain securely and easily.
#### Available on the AppStore:
{% embed url="" %}
{% hint style="info" %}
If the app is not available in the AppStore in your country, follow these steps:
1. [Download](https://apps.apple.com/ae/app/testflight/id899247664) the TestFlight app.
2. Go to the [link](https://testflight.apple.com/join/Bjz0XZ5v), add Axiome Wallet to TestFlight, and install it. Future updates will be installed automatically.
{% endhint %}
#### Available on Google Play:
{% embed url="" %}
{% hint style="info" %}
If the app is not available on Google Play in your country, [download the APK file](https://axiome.fra1.cdn.digitaloceanspaces.com/releases/android/axmapp-release-2-8-86.apk).
{% endhint %}
# AXM Coin
Learn about AXM Coin - its role in Axiome Chain, how supply, burning, staking, and token utilities work in the ecosystem.
**The AXM coin performs several key functions within the Axiome ecosystem:**
* Represents ownership share of the Community Pool income.
* Serves as the base asset in liquidity pools on Axiome Swap.
* Acts as the base asset on Axiome Pump, used for all new token presales.
* Functions as the margin collateral when trading on Axiome Futures.
* Used to pay network fees.
* AXM staking is the core element of the DPoS consensus to support the operation of Axiome Chain.
## Important links
**Buy / Sell AXM:**
* [On MEXC](https://www.mexc.com/exchange/AXM_USDT)
* [On Biconomy](https://www.biconomy.com/exchange/AXM_USDT)
* [On Tapbit](https://www.tapbit.com/spot/exchange/AXM_USDT?tab=USDT)
* [P2P-bot](https://t.me/axiome_p2p_bot) (for users from Russia and Belarus)
* [CoinMarketCap](https://coinmarketcap.com/currencies/axiome/)
* [Coingecko](https://www.coingecko.com/en/coins/axiome)
***
## Issuance
The maximum supply is **1,000,000,000 AXM**.
{% hint style="success" %}
✅ AXM mining is complete.\
No new coins will be minted, while burning continues.\
AXM tokenomics is now deflationary.
{% endhint %}
Since the very launch of Axiome, the development team has managed only one wallet, which is the company’s sole wallet. View it in the [block explorer](https://axiomechain.org/address/axm1ytal6q2qc3rkha3x24m4ynh9nvzmpkm8lucq00). All remaining AXM issuance is owned and controlled by Axiome community users.
***
## Burning AXM
There are four ways to burn AXM:
### 1. **When activating Premium (always)**
Each time a user pays for a Premium subscription, 50% of the amount is burned and the remaining 50% is allocated to the Community Pool.
### 2. Burning upon undelegation (always)
With every undelegation of AXM, you pay a 10% fee on the amount being undelegated, which is subject to instant burning 30 days after the undelegation is initiated.
### 3. Burning network fees (always)
All AXM-related transactions incur network fees. Of each fee, 30% is burned, and the remainder is distributed as delegation rewards (the [share of network fees](https://docs.axiomeinfo.org/axiome-chain/pages/eQeAguH0AYAZIuhREAcU#id-2.-share-of-network-fees)).
### 4. Buyback-and-burn from [Axiome Futures](/axiome-trade/axiome-futures) profits
Every week, 10% of the trading fees collected on Axiome Futures will be used to buy back AXM and burn it immediately.
# AXM Staking
Complete guide to staking AXM coin on Axiome Chain: detailed overview of reward types and risk management.
DPoS (Delegated Proof of Stake) delegation is a mechanism for securely transferring (locking) your AXM in a validator’s stake. This mechanism was developed for the following purposes:
* Strengthening the stability of Axiome Chain. The more AXM is locked, the harder it is to influence consensus.
* Mining new AXM - ✅ Completed
* Providing the community with an attractive source of rewards.
* Reducing the circulation of free coins.
## Types of rewards
There are two types of staking rewards:
### 1. Share of Community Pool income
With the development of the Axiome ecosystem, the Community Pool will become one of the most attractive ways of generating profit in the cryptocurrency market.
This solution is an exceptionally effective method of rewarding stakers with multiple liquid rewards at once.
**The method of distributing the pool’s profit is extremely simple:**
1. Just go to the block explorer.
2. Open the Community Pool section.
3. Connect your wallet.
4. Claim your accumulated rewards with a single click!
{% hint style="info" %}
Read more about what the Community Pool is [here](/axiome-chain/community-pool).
{% endhint %}
### **2. Share of network fees**
All transactions in Axiome Chain require a fee paid to validators for execution. 30% of the collected fees are burned, and the remaining amount is distributed as follows: 70% to the validator’s delegators and 30% to the validator itself for maintaining and improving its node.
{% hint style="info" %}
**Example:**
The total fee from all transactions included in a block amounted to 100 AXM. 30% (30 AXM) is immediately burned.
Seven validators participated in signing the block, splitting the remaining fee equally (10 AXM each).
You delegated 200 AXM to one of these validators, while the validator’s total stake is 1,000 AXM. Thus, your share in the validator’s stake is 20%. This means your reward is 20% of the fees collected by the validator, minus the validator’s 30% commission.
Result: (10 – 30%)\* 0.2 = 1.4 AXM.
{% endhint %}
{% hint style="warning" %}
* Choose reliable validators. If a validator misses a block, you won’t earn rewards for that block.
* In the [block explorer](https://axiomechain.org/validators), pay attention to the **Uptime** indicator. The higher this indicator, the more stable the validator.
* Delegate to multiple validators to minimize the risk of missing out on rewards.
{% endhint %}
***
***
## How to delegate AXM?
**Step 1.** In the Axiome Wallet mobile app, go to the “Staking” tab and open the “AXM Staking” section.
**Step 2.** Click the “Delegate” button.
**Step 3.** Choose a validator, specify the amount and click “Confirm.” Your AXM will be transferred from your wallet to the stake of the chosen validator.
***
## Where do delegation rewards go?
All delegation rewards accumulate in the same section (AXM Staking) under the “Delegated” card. Click “Claim” to transfer rewards to your wallet.
***
## How to undelegate AXM?
**Step 1.** Go to the “AXM Staking” section and click the “Undelegate” button.
**Step 2.** Select the validator and enter the amount for undelegation. Then click “Confirm.”
{% hint style="info" %}
After 30 days, your AXM will be moved back to your wallet minus a 10% burn fee.
{% endhint %}
{% hint style="warning" %}
You can have a maximum of 7 active undelegations within a single validator.
{% endhint %}
***
## How to cancel undelegation?
If you cancel an active undelegation before it is completed, your AXM will return to the validator’s stake, and the 10% burn will not occur.
**Step 1.** Find the transaction titled “Initiating Undelegation” in your AXM wallet’s transaction history.
**Step 2.** Click on this transaction and in the pop-up window, press the “Cancel” button.
**Step 3.** Refresh the page, find the same “Initiating Undelegation” transaction again, and make sure there is a red cross next to the amount, confirming that the undelegation was canceled and the AXM returned to the validator’s stake. You will also see a new transaction appear in your history: “Cancel Undelegation”.
{% hint style="success" %}
Canceling undelegation resumes rewards on your AXM.
{% endhint %}
# Community Pool
The ultimate share revenue model on Axiome Chain! Community Pool distributes ecosystem fees in multiple assets to AXM stakers and RET holders.
## What is the Community Pool?
It is perhaps the first real case in the cryptocurrency market where a blockchain’s native token provides the opportunity to earn income from all the flagship products of the ecosystem.
The Community Pool is a vault of collected rewards, consisting of a variety of assets coming from different ecosystem solutions.
* **70%** of the total Community Pool income is distributed among [AXM](/axiome-chain/axm-coin) stakers.
* **30%** goes to [RET](/axiome-chain/partnership-program#ret-referral-energy-token) token holders.
**To verify the transparency of Community Pool inflows, use the block explorer:**
{% embed url="" %}
## Sources of Community Pool funding
{% hint style="warning" %}
An active [Premium subscription](/axiome-chain/axiome-premium-subscription) is required for your wallet to participate in the Community Pool rewards distribution.
{% endhint %}
### 1. Fees from Axiome Swap
**20% of the trading fee collected by Axiome Swap at the moment of any trade, regardless of the pair, goes to the Community Pool.** The remaining 80% goes to the liquidity providers of the pool.
{% hint style="info" %}
**Example:**
In the CHAPA/AXM pair pool, the swap fee is set at 1%. That means a trader, when buying/selling CHAPA or AXM, pays a fee of 1% of the asset being sold.
Suppose a trader sells 10,000 CHAPA to buy AXM. As a result, they pay 100 CHAPA as a trading fee.
Of those 100 CHAPA:
* 80 CHAPA (80%) goes to liquidity providers as a reward.
* 20 CHAPA (20%) goes to the Community Pool.
{% endhint %}
Thanks to Axiome Swap, our Community Pool will accumulate a large variety of assets, allowing pool shareholders to reliably diversify their income!
### 2. Premium subscription activation
Each time a user pays for a [Premium](/axiome-chain/axiome-premium-subscription) subscription, 50% of the amount is burned and the remaining 50% is allocated to the Community Pool.
### 3. Fees from Axiome Pump
100% of all fees collected by Axiome Pump will be directed to the Community Pool:
* **$50** in AXM for creating a token.
* **10%** of the total AXM raised during a presale.
### 4. Fees from Axiome Futures
Axiome Futures will collect trading fees in highly liquid assets such as USDT, USDC, and AXM.
The weekly distribution of collected fees is as follows:
* 50% goes to liquidity providers (market makers) in the order book, depending on the pair and the amount of liquidity provided.
* 40% goes to the Community Pool.
* 10% is used for the weekly buyback and burn of AXM.
### 5. Fees from projects in the Axiome Accelerator
One of the key requirements for projects joining our accelerator will be allocating at least 15% of their generated revenue to the Community Pool.
{% hint style="info" %}
Each accelerator project will be announced individually on our [Telegram channel](https://t.me/axiomeen) and [Twitter](https://twitter.com/axiome_pro).
{% endhint %}
## Where to find the Community Pool?
You will be able to monitor the status of the Community Pool in the block explorer at [axiomechain.org](https://axiomechain.org/) right after its release:
**In this section of the explorer you will be able to:**
* Monitor all statistical metrics related to the total rewards paid to [AXM](/axiome-chain/axm-coin) and [RET](/axiome-chain/partnership-program#ret-referral-energy-token) holders over time.
* Track the pool balances across all assets it contains.
* Connect your wallet to view your share of the pool’s income based on the amount of AXM and RET in your balance.
* Claim your rewards from the pool.
* View the ranking of Community Pool shareholders.
{% hint style="info" %}
Subscribe to us so you don’t miss the Community Pool launch announcement:
🇬🇧 [Telegram in English](https://t.me/axiomeen)
🇷🇺 [Telegram на русском](https://t.me/axiomeru)
🇩🇪 [Telegram Auf Deutsch](https://t.me/axiomede)
[Twitter](https://twitter.com/axiome_pro)
{% endhint %}
# Partnership Program
The Axiome Chain Partnership Program: invite users, gain AXM rewards, access tools and exclusive benefits for growing ecosystem together!
## Partnership Reward
For each AXM [delegation](/axiome-chain/axm-staking) made by invited users in your team (up to 14 levels deep), RET tokens are minted at 15% of the delegated AXM amount and distributed to higher-level wallets.
{% hint style="info" %}
For example, if a user delegates 1,000 AXM, Axiome Chain mints 150 RET tokens, which are distributed to upstream users based on their level and status.
{% endhint %}
***
## Statuses
{% hint style="warning" %}
To start receiving partnership rewards, you must reach the Starter status. If you lose this status, you will stop receiving partnership rewards.
{% endhint %}
**There are 7 statuses:**
When calculating status conditions, the metrics of all invited users up to your 14th level are taken into account, even if these levels are not yet unlocked by your current status. Unlocking a level with your status gives you the ability to receive partnership rewards from invitees at those levels.
{% hint style="success" %}
New users who did not specify an inviter during registration are automatically distributed into the first line among wallets with **Guru** status. A small but nice bonus for growing within the status program.
You will receive a push notification **“Random user”** in the Axiome Wallet app when such a user joins your team.
{% endhint %}
{% hint style="warning" %}
If you do not meet the conditions of your current status, you have 7 days to catch up. If after 7 days the conditions are still not met, you will be downgraded to the status whose conditions are fulfilled.
{% endhint %}
***
## Levels and percentages
Progress in the status system directly affects the unlocking of new levels in the partnership program. Below are the percentages you receive from the delegation amount of your invitee depending on their level relative to you.
| Level | Status | Percentage |
| :---: | :--------: | :--------: |
| 1 | by Starter | 3% |
| 2 | | 1% |
| 3 | by Leader | 1% |
| 4 | | 1% |
| 5 | by Guru | 1% |
| 6 | | 1% |
| 7 | by Boss | 1% |
| 8 | | 1% |
| 9 | by Pro | 1% |
| 10 | | 1% |
| 11 | by Top | 1% |
| 12 | | 1% |
| 13 | by Mega | 0.5% |
| 14 | | 0.5% |
{% hint style="success" %}
By reaching the **Mega** status, you unlock the ability to receive partnership rewards from all 14 levels.
{% endhint %}
***
## Where can you find your team and progress in the status system?
Your partnership structure, as well as your progress in the status system, can be found in the [block explorer](https://axiomechain.org/):
**Step 1.** Open the Axiome Wallet mobile app and in the **“My Profile”** section click the **“Open at Explorer”** button:
**Step 2.** You will be redirected to the block explorer on your wallet page. Scroll down a bit, and in the **“Team”** tab you will find a list of all users up to your 14th level.
{% hint style="success" %}
The full transparency of the ecosystem allows you to analyze the activity of any Axiome user.
{% endhint %}
**Step 3.** To view your progress in the status system, click on your current status and you will be taken to the progress page.
**Step 4.** Click **“More”** to see the degree of status condition fulfillment.
***
## How to register a new user?
{% hint style="info" %}
For a new user to register into your team at the first level, you must first [delegate](/axiome-chain/axm-staking#how-to-delegate-axm) at least 1 AXM. This requirement protects Axiome Chain from spam account attacks.
{% endhint %}
**Step 1.** Go to the **“My Profile”** section in the mobile app and copy your nickname by tapping on it.
**Step 2.** Send your username to the new user. They must enter it in the **“Your inviter”** field on the registration page.
Done! After completing the registration process, the new user will appear in your team at level 1.
***
## Where do partnership rewards go?
All partnership rewards are credited to your wallet immediately after any of your invited users delegate their AXM.
Open the Axiome Wallet app, go to the **“Wallet”** tab, select RET, and find all your partnership rewards in the transaction history:
***
## RET - Referral Energy Token
### What is RET for?
After the full issuance of AXM, AXM staking will no longer generate [fixed percentages](https://docs.axiomeinfo.org/axiome-chain/pages/eQeAguH0AYAZIuhREAcU#id-1.-mining-new-axm) as delegation rewards. As a result, the 15% partnership fee will no longer be charged on new AXM delegations. At this point, RET comes into play, giving new life to the partnership program.
In fact, with the launch of RET, only one criterion changes:
**Previously, for the delegation of your invitees you received AXM → Now you will receive RET 1:1, as you would have received AXM.**
{% hint style="info" %}
**Example:**
You personally invited a user. Since this user is on level 1 of your partnership structure, you are entitled to receive [5%](#levels-and-percentages) of their delegation.
Suppose this user delegated 1,000 AXM. Your reward would be 50 AXM.
But with RET, you will receive 50 RET instead of 50 AXM, because after the completion of AXM issuance, the 15% partnership fee will no longer be deducted from delegations.
{% endhint %}
### Where do RET tokens come from?
They are minted at the moment of partnership reward distribution. Therefore, RET issuance is unlimited.
The more AXM users delegate, the more RET is emitted.
### RET utility:
* 30% of all [Community Pool](/axiome-chain/community-pool) income belongs to RET holders! The remaining 70% goes to AXM stakers.
* Provides up to 30% discount on network fees. During a transaction, you will be able to burn RET from your balance to cover up to 30% of the network fee, based on the current exchange rate to AXM.
* A fully tradable asset. From day one after launch, a RET/AXM pool will be created on Axiome Swap. Even though RET will be minted 1:1 with AXM, its market price will differ. Especially in the first 6–12 months, RET’s price may even be higher than AXM due to the relatively small RET issuance compared to its entitlement to 30% of Community Pool assets.
* A deterministic token of the partnership program, giving momentum to community scaling through generous rewards.
# Axiome Premium subscription
Axiome Premium Subscription offers enhanced tools and exclusive perks across the Axiome Chain ecosystem.
## What is Premium?
The goal of Axiome Premium is to provide as much additional functionality as possible to users who contribute to maintaining a healthy AXM tokenomics.
* To activate Premium, you need to pay AXM worth $5 at the current price at the time of the transaction.
* Premium is activated for 30 days. Don’t forget to renew it to keep your benefits.
{% hint style="info" %}
**Important!**
50% of each payment is burned immediately, while the remaining 50% is allocated to the Community Pool. The Axiome team does not benefit from Premium subscription activations.
{% endhint %}
After activation, you unlock the following features:
* Access to the [Community Pool](/axiome-chain/community-pool) rewards distribution.
* Ability to participate in [promo campaigns](https://axiome.club/en).
* Ability to change your nickname through the Axiome Wallet app.
* Ability to change your profile photo through the Axiome Wallet app.
* A diamond icon displayed next to your nickname.
## How to get Premium?
Premium subscription can only be activated via the block explorer by paying AXM worth $5 at the current price at the time of the transaction. Follow these simple steps:
**Step 1.** In the Axiome Wallet mobile app, go to the **“My Profile”** tab and tap the **“Open at Explorer”** button. You will be redirected to the block explorer with your wallet already authorized:
**Step 2.** On the block explorer page, expand the menu and click the **“Get Premium”** button.
**Step 3.** Follow the instructions in the pop-up window. After tapping “Pay,” you will be automatically redirected to the mobile app, where you need to confirm the transaction.
{% hint style="info" %}
If you downloaded Axiome Wallet via TestFlight and the redirect from the explorer to the mobile app does not happen automatically, you will need to take the following steps to confirm the transaction:
* Copy the transaction authorization code from the block explorer page.
* In the Axiome Wallet app, open the 🔌 **Axiome Connect** feature.
* Paste the authorization code into the corresponding field and confirm the transaction.
{% endhint %}
**Step 4.** After confirming the transaction in Axiome Wallet, return to the block explorer and refresh the page.
Done!
# Roadmap
## 2026
### **1. AXIOME TRADE**
A multi-trading platform built on Axiome Chain v2.0. The exchange functionality will include three main components:
* **Axiome Pump -** a solution for issuing your own token in just two clicks and conducting large-scale presales to the Axiome audience.
* **Axiome Swap -** a spot AMM exchange for all tokens issued on Axiome Chain.
* **Axiome Futures -** a terminal for perpetual derivatives trading. Our goal is to allow tokens issued on Axiome Chain to access the futures market once they meet the capitalization and trading volume requirements on Axiome Swap.
### 2. Completion of AXM emission
Transition of the partnership program from AXM payouts to RET rewards.
### 3. Introducing DAO
The best and fairest way for the community to independently determine Axiome’s direction of development.
{% hint style="info" %}
**Follow us on social media so you don’t miss the release of new solutions in the ecosystem:**
🇬🇧 [Telegram in English](https://t.me/axiomeen)
🇷🇺 [Telegram на русском](https://t.me/axiomeru)
🇩🇪 [Telegram Auf Deutsch](https://t.me/axiomede)
[Twitter](https://twitter.com/axiome_pro)
[Axiome Pay ](https://axiomepay.com/en)- crypto cards
[Block Explorer](https://axiomechain.org/)
**Buy AXM:**
[On MEXC](https://www.mexc.com/exchange/AXM_USDT)
[On Biconomy](https://www.biconomy.com/exchange/AXM_USDT)
[On Tapbit](https://www.tapbit.com/spot/exchange/AXM_USDT?tab=USDT)
[P2P-bot](https://t.me/axiome_p2p_bot) (for users from Russia and Belarus)
[CoinMarketCap](https://coinmarketcap.com/currencies/axiome/)
[CoinGecko](https://www.coingecko.com/en/coins/axiome)
[LinkTree](https://linktr.ee/axiome_pro) - all links
{% endhint %}
# Details of Axiome Pay
Explore Axiome Pay - a secure payment service with virtual and physical cards, instant USDT/USDC top-ups, transparent fees, and a generous bonus program.
{% embed url="" %}
Axiome Pay - a crypto card aggregator for every occasion!
**Axiome Pay app:**
[Telegram Mini App](https://t.me/axiome_pay_bot)
[Google Play](https://play.google.com/store/apps/details?id=com.axiome.pay)
[IOS (TestFlight)](https://testflight.apple.com/join/jn2BUs6Z)
## **Key features:**
* Wide selection of cards for different needs.
* Apple Pay and Google Pay support.
* Instant balance top-ups in USDT and USDC TRC-20 + BSC-20.
* High spending limits - some cards even have no limits at all.
* Cash withdrawals with our Physical Visa Pro card.
* Low top-up fees.
* A unique cashback program. We reward you with AXP (Axiome Pay Token) for every dollar you spend, based on your status.
* An advanced status system - the more AXP you hold in your wallet or in the [AXP/AXM liquidity pool](https://app.axiometrade.pro/swap/pools/axm1qsufk856fmakeycjq5swmtd53l4drqtu4xefdfuu9h4m5ce89rhschkv0c) on Axiome Swap, the better your card top-up conditions become!
* Simple and fast card issuance.
## Statuses
{% hint style="info" %}
* Statuses apply to all issued cards.
* Both AXP held in your wallet and AXP supplied to the [AXP/AXM liquidity pool](https://app.axiometrade.pro/swap/pools/axm1qsufk856fmakeycjq5swmtd53l4drqtu4xefdfuu9h4m5ce89rhschkv0c) on Axiome Swap count toward your status.
* To confirm your status, you must link your wallet in the [Axiome Wallet app](/axiome-wallet-app) to your Axiome Pay account.
{% endhint %}
## AXP Cashback Program
Bonus points are automatically credited for every dollar spent!
**Step 1.** Pay for your purchases, using your Axiome Pay cards.
**Step 2.** Earn AXP on every dollar spent according to your status.
**Step 3.** Claim your accumulated AXP to your Axiome wallet.
**Step 4.** Swap the AXP you’ve earned on [Axiome Swap](https://app.axiometrade.pro/swap/AXM-AXP) or provide liquidity to the [AXP/AXM](https://app.axiometrade.pro/swap/pools/axm1qsufk856fmakeycjq5swmtd53l4drqtu4xefdfuu9h4m5ce89rhschkv0c) pair to earn trading fees! You can also save your AXP to reach a higher status!
{% hint style="info" %}
To credit your accumulated AXP, go to the “**Profile**” section in the Axiome Pay app and tap the “**Claim to wallet**” button. Then enter the amount of AXP you want to claim and specify your Axiome Chain address to receive the tokens.
{% endhint %}
# Product overview
Discover Axiome Trade: a next-generation decentralized platform with seamless token swaps, advanced trading features, and secure architecture.
#### **Trade and earn on Axiome Trade:**
{% embed url="" %}
Axiome Trade is one of the central products of the Axiome ecosystem, bringing together three directions within a single interface:
1. [**Axiome Swap**](/axiome-trade/axiome-swap) - a decentralized AMM exchange that enables token swaps for assets issued on Axiome Chain.
2. [**Axiome Pump**](/axiome-trade/axiome-pump) **-** a launchpad product for creating your own token in just two clicks and conducting large-scale presales for the entire Axiome audience. After a successful presale, new tokens are automatically migrated to Axiome Swap in a pair with AXM.
3. [**Axiome Futures**](/axiome-trade/axiome-futures) - a decentralized orderbook exchange for perpetual futures, combining in one terminal the best of CEX experience with the strongest aspects of decentralized trading.
## **Axiome Trade and the Community Pool**
{% hint style="info" %}
More details about the Community Pool are described [here](/axiome-chain/community-pool).
{% endhint %}
Axiome Trade is the most sustainable source of contributions to the Community Pool with various liquid assets, in particular:
* **20%** of all Axiome Swap trading fees in multiple assets go to the Community Pool.
* **100%** of all Axiome Pump fees go to the Community Pool.
* **40%** of all Axiome Futures trading fees collected in liquid assets (USDT, USDC, AXM) go to the Community Pool.
Thus, beyond exceptional user functionality and the convenience of uniting three products in one place, Axiome Trade strengthens AXM tokenomics by bringing numerous rewards to AXM stakers under the Share Revenue model.
{% hint style="success" %}
Simply put, if you are an AXM staker, in addition to the classic staking rewards in the form of mining new native coins and a share of network fees, you also start earning a share of the income from the most effective projects of the Axiome ecosystem through the Community Pool.
{% endhint %}
# Axiome Swap
Axiome Swap: trade tokens on the Axiome Chain, create liquidity pools in just 2 clicks, and start earning rewards today!
#### Create your tokens, trade, and earn by providing liquidity on Axiome Swap:
{% embed url="" %}
Axiome Swap is a spot AMM exchange for tokens issued on Axiome Chain, forming part of the Axiome Trade ecosystem cluster. This product offers a particularly user-friendly interface and a well-designed economy.
Axiome Swap is one of the key sources of funding for the [Community Pool](/axiome-chain/community-pool) - 20% of all collected trading fees go into the pool and are then distributed among AXM stakers and RET token holders.
{% hint style="info" %}
Tokens that successfully complete a presale on Axiome Pump will be automatically migrated to Axiome Swap in a pair with AXM.
{% endhint %}
In fact, there are only two user roles on Axiome Swap:
* **Traders** - those who buy or sell assets on Axiome Swap. For these users, two sections are relevant: "Swap" and "Tokens".
* **Liquidity providers** - either token creators who set up a liquidity pool (for example, $TOKEN/AXM) to allow their audience to buy or sell the token, or holders of various tokens who decide to earn additional income by providing these tokens as liquidity to pools in order to receive their share of trading fees. For these users, two other sections are relevant: "Positions" and "Pools".
By understanding this division of roles, it will be easier for you to read this document if you are new to the field.
## How to swap assets on Axiome Swap?
To swap assets, follow a few simple steps:
**Step 1.** Open the Axiome Trade app and go to the **“Swap”** section:
{% embed url="" %}
**Step 2.** Connect your wallet through the [Axiome Wallet](/axiome-wallet-app) app.
{% hint style="info" %}
In the mobile version, you will be prompted to log in either through an automatic redirect to the Axiome Wallet app or by entering an authorization code.
{% endhint %}
**Step 3.** Select the asset to sell and the asset to buy from the list by tapping the asset icon in each field.
**Step 4.** Enter the selling amount in the **“Selling”** field or the buying amount in the **“Buying”** field.
**Step 5.** Click the **“Swap”** button.
**Step 6.** Open the Axiome Wallet app and confirm the transaction in the automatically opened window.
Done! ✅
## How is the swap fee formed?
The swap fee structure is as follows:
1. When creating a pool, the creator sets the base fee level.
2. The contract automatically calculates an additional 20% of the pool creator’s fee.
3. The contract aggregates the total fee (base + 20%), which is shown to the trader in the swap details at the time of exchange.
{% hint style="info" %}
**Example:**
The pool creator sets a 1% fee.
Axiome Trade’s fixed fee is 20% for all pairs.
As a result, the trader pays 1% + 0.2% (20% of 1%) = **1.2%**.
The full Axiome Trade fee portion is automatically sent to the [Community Pool](/axiome-chain/community-pool) for further distribution between AXM stakers (70%) and RET holders (30%).
{% endhint %}
## Features of working with liquidity pools
### 1. How to create a liquidity pool?
To create your own liquidity pool (a new market), go to the **“Pools”** section, click the **“Create pool”** button, and follow these steps:
**Step 1.** At this stage, you need to define the pair and the fee level.
* The **“Base asset”** field refers to the asset for which the market is being created - in most cases, this is the token you have issued yourself.
* The **“Quote asset”** field specifies the asset that defines the value of the base one - at this stage, AXM will be automatically selected.
In the fee selection field, follow the recommendations in the dropdown menu. The higher the fee, the more liquidity providers earn from your pool. However, it’s important to maintain a balance between attractiveness for liquidity providers and traders.
{% hint style="info" %}
At the early stage, we recommend setting a 1% fee for all new pairs.
{% endhint %}
**Step 2.** Next, you need to set the starting price of the base asset in AXM and choose the price range in which your liquidity will operate.
The price setup depends on the goals of your project - the lower the starting price, the fewer AXM are required to create the pool and support price growth, and vice versa.
{% hint style="info" %}
At this stage, users can provide liquidity only across the full price range. Therefore, the **“Price range”** field will have the **“Full Range (AMM)”** parameter selected by default.
Subscribe to our Telegram to stay informed about the upcoming update that will introduce liquidity provision within a **custom price range (CLMM):**
🇬🇧 [Telegram in English](https://t.me/axiomeen)
🇷🇺 [Telegram на русском](https://t.me/axiomeru)
🇩🇪 [Telegram Auf Deutsch](https://t.me/axiomede)
{% endhint %}
**Step 3.** At this step, you’ll need to specify the initial liquidity amount you intend to provide to open the pool. However, the actual deposit will be made in the next (final) step, after the pool has been created by the Axiome Swap contract.
Enter the amount of the base asset - the AXM value will be automatically calculated based on two criteria:
* The price you set.
* The requirement to maintain a 1:1 value ratio between both assets.
Click **“Create pool.”**
A window will appear indicating that your liquidity pool is being created. Click “Open” to navigate to the pool page:
**Step 4.** Final step: you’ll need to deposit the initial liquidity to make the pool publicly available to all users - both liquidity providers and traders.
{% hint style="info" %}
At this step, you can adjust the amount of assets you wish to deposit once more.
{% endhint %}
Click **“Create Position.”**
A **“Preview Deposit”** window will open - double-check the entered information, and if everything is correct, click **“Confirm”:**
Open the Axiome Wallet app and sign the transaction:
Done! 🎉 Congratulations on creating a new market.
### 2. Steps for adding liquidity
**Step 1.** To start earning by providing liquidity to pools, go to the **“Pools”** section and choose the market where you want to add liquidity:
**Step 2.** Open the selected pool’s page. Here you’ll find key historical statistics, the pool’s balances and their proportions, as well as the total rewards earned by the pool:
**Step 3.** Scroll down a bit to find the liquidity provision section. Enter the amount in either asset - the value of the second asset will be automatically calculated based on the current base asset price in AXM. Then click **“Create Position":**
A **“Preview Deposit”** window will appear. Double-check all entered data, and if everything is correct, click **“Confirm”:**
**Step 4.** Open the Axiome Wallet app and sign the transaction:
Done! ✅
### 3. How are fees distributed among liquidity providers?
To understand how the liquidity pool’s earned fees are distributed, it’s important to first understand how liquidity itself is provided:
When you create a liquidity pool or add liquidity to an existing one, LP tokens (liquidity provider tokens) are minted in proportion to the value of the liquidity you contribute relative to the total pool value. Simply put, LP tokens are a digital confirmation that you have supplied liquidity to a specific pool.
**Step-by-step process of LP token issuance:**
1. When your liquidity provision transaction is confirmed, your tokens are sent to the pool’s smart contract.
2. The contract records how much liquidity was in the pool before your deposit and calculates your proportional share.
3. Immediately after adding liquidity, LP tokens are automatically issued to you in the amount that reflects your proportional share of the pool.
{% hint style="info" %}
**Example:**
The pool contains 100,000 TOKEN + 100,000 AXM.
There are 10,000 LP tokens in circulation.
You add 10,000 TOKEN + 10,000 AXM → you receive 1,000 LP tokens (10%).
{% endhint %}
You can find your LP tokens after providing liquidity in the [block explorer](https://dev.axiomechain.org/) on your wallet page under the **“Asset”** tab. LP tokens are labeled as: **WasmSwap\_Liquidity\_Token**.
### 4. How your income in the pool is formed?
Each time buy and sell trades pass through the pool, a trading fee (for example, 1%) is added to the pool. These fees are not distributed immediately but instead increase the total amount of tokens within the pool.
This means your share in LP tokens remains the same, but the **value of each LP token increases** because the pool has grown in size.
Therefore, when you withdraw, you receive more assets than you initially deposited - provided that a significant number of trades have occurred.
To compare how much liquidity you originally supplied versus the current valuation of your liquidity, pay attention to the **“Deposit Value”** and **“Current Value”** indicators in your position details:
* **Deposit Value** - the valuation of your assets at the moment they were added to the pool. After adding or removing liquidity from an existing position, this indicator is adjusted.
* **Current Value** - the current valuation of your share in the pool, expressed in USD.
In other words, to determine your income, simply subtract Deposit Value from Current Value - the difference represents your actual profit.
{% hint style="info" %}
Simply put, **Deposit Value** is the price of your LP tokens at the moment of liquidity provision, while **Current Value** reflects their value at the current time.
{% endhint %}
### 5. Liquidity removal
1. In practice, you send your LP tokens back to the pool contract via a transaction.
2. The contract burns your LP tokens.
3. In return, you receive your proportional share of the pool’s assets (including your portion of accumulated trading fees).
{% hint style="info" %}
To keep the interface clean and simple at the early stage, we decided not to implement direct user interaction with LP tokens - the entire process is streamlined for intuitive simplicity.
{% endhint %}
**Important:**
When withdrawing liquidity from a pool, you must understand that even if your share has increased in value, you will not withdraw assets in the same proportions as when you supplied them - due to pool rebalancing.
{% hint style="info" %}
**Example scenario:**
The pool consists of 100 TOKEN (priced at 1 AXM each) + 100 AXM.
Your share (1%) = **1 TOKEN + 1 AXM**.
The TOKEN price doubles → 2 AXM.
To maintain balance (according to the formula *x\*y = k*), the new pool composition becomes 70.7 TOKEN and 141.4 AXM.
Your share (1%) = **0.707 TOKEN + 1.414 AXM**.
{% endhint %}
## Managing positions
### 1. How to manage a position?
Managing a position involves two scenarios:
* Adding liquidity.
* Removing liquidity.
To manage your position, go to the **“Positions”** section and click the **“Manage”** button next to the selected position:
To increase your position size, open the **“Add”** tab, enter the amount of one asset - the value of the second asset will be filled in automatically - and then confirm the transaction:
To remove liquidity from a position, open the **“Remove”** tab, enter the amount of liquidity you want to withdraw, and confirm the transaction:
{% hint style="info" %}
Please note that any interaction with the Axiome Trade contract requires signing the transaction in the Axiome Wallet app.
{% endhint %}
### 2. How to share a position?
To share the performance of your position, go to the **“Positions”** section and click the **“Share”** button next to the selected position:
You’ll be prompted to download an image showing your position’s performance:
Share your results with friends or on social media and grow within the [partnership program](/axiome-chain/partnership-program).\
At the bottom of the image, your nickname and a QR code for downloading the Axiome Wallet app will be displayed.
## Types of slippage and their settings
Slippage is the difference between the price at which you expected to execute a transaction and the price at which it was actually executed.
**Causes:**
* Low pool liquidity.
* Trade volume too large relative to the pool size.
* Price change during transaction confirmation.
* High asset volatility.
**In Axiome Swap, there are two types of slippage:**
1. When swapping assets.
2. When providing liquidity to a pool.
In both cases, you can set a **maximum slippage tolerance** by clicking the settings icon:
{% hint style="info" %}
**Recommended maximum slippage values:**
* **1–4%** - moderately volatile pairs.
* **5–7%** - highly volatile pairs.
* **7% and above** - unstable pairs with low liquidity volume.
{% endhint %}
# Axiome Pump
This section is under development. Subscribe to our social media to not miss the Axiome Pump announcement:
{% hint style="info" %}
**Important Links:**
🇬🇧 [Telegram in English](https://t.me/axiomeen)
🇷🇺 [Telegram на русском](https://t.me/axiomeru)
🇩🇪 [Telegram Auf Deutsch](https://t.me/axiomede)
[Twitter](https://twitter.com/axiome_pro)
[Axiome Pay ](https://axiomepay.com/en)- crypto cards
[Block Explorer](https://axiomechain.org/)
**Buy AXM:**
[On MEXC](https://www.mexc.com/exchange/AXM_USDT)
[On Biconomy](https://www.biconomy.com/exchange/AXM_USDT)
[On Tapbit](https://www.tapbit.com/spot/exchange/AXM_USDT?tab=USDT)
[P2P-bot](https://t.me/axiome_p2p_bot) (for users from Russia and Belarus)
[CoinMarketCap](https://coinmarketcap.com/currencies/axiome/)
[CoinGecko](https://www.coingecko.com/en/coins/axiome)
[LinkTree](https://linktr.ee/axiome_pro) - all links
{% endhint %}
# Axiome Futures
This section is under development. Subscribe to our social media to not miss the Axiome Futures announcement:
{% hint style="info" %}
**Important Links:**
🇬🇧 [Telegram in English](https://t.me/axiomeen)
🇷🇺 [Telegram на русском](https://t.me/axiomeru)
🇩🇪 [Telegram Auf Deutsch](https://t.me/axiomede)
[Twitter](https://twitter.com/axiome_pro)
[Axiome Pay ](https://axiomepay.com/en)- crypto cards
[Block Explorer](https://axiomechain.org/)
**Buy AXM:**
[On MEXC](https://www.mexc.com/exchange/AXM_USDT)
[On Biconomy](https://www.biconomy.com/exchange/AXM_USDT)
[On Tapbit](https://www.tapbit.com/spot/exchange/AXM_USDT?tab=USDT)
[P2P-bot](https://t.me/axiome_p2p_bot) (for users from Russia and Belarus)
[CoinMarketCap](https://coinmarketcap.com/currencies/axiome/)
[CoinGecko](https://www.coingecko.com/en/coins/axiome)
[LinkTree](https://linktr.ee/axiome_pro) - all links
{% endhint %}
# List of partner products
### **AXIOME PULSE**
An analytics and notification service for users of the Axiome ecosystem. The product helps track wallet activity, receive alerts about important events, monitor account changes, and overall makes interacting with the ecosystem significantly more convenient. It serves as an infrastructure layer for active users, investors, delegators, and anyone who values data transparency and fast access to on-chain signals.
{% embed url="" %}
### **AXIOME VPN**
Axiome VPN is a VPN service within the Axiome ecosystem, with payments available in AXM and rubles. It’s a utility product that solves a real user need while demonstrating a practical use case for the token. A key feature is the simplified onboarding via a Telegram bot, with no need to manage servers or deal with complex VPN setup.
{% embed url="" %}
### **COLLEXIUM**
An NFT / digital collectibles vertical within the Axiome ecosystem. This project expands beyond purely financial use cases by enabling cultural, community-driven, and creator-focused experiences. It has the potential to serve as a foundation for launching collections, branded digital assets, partnership collaborations, and user-generated content that can extend the ecosystem beyond finance.
* [**CLX Token**](https://axiomechain.pro/token/axm1hfaf96lt2y2dx2cr04svej0s0srqydhncxga5lh6zlrzw77d8qzqxday46)
* [**Marketplace Bot**](https://t.me/Collexium_bot)
* [**Telegram Channel**](https://t.me/CollexiumMarketplace)
* [**CLX / AXM Trading**](https://app.axiometrade.pro/ru/swap/AXM-CLX)
### TRAVIS RUN
A gaming product within the Axiome ecosystem, designed for a Telegram-native audience, featuring missions, seasonal mechanics, in-game progression, and user retention through gamification. It serves as a key example of a consumer-layer product in Axiome, bringing users back to the ecosystem not only for trading or asset storage, but also for engaging activities and progression.
* [**Travis Run Game**](https://t.me/trvsrunbot)
* [**Telegram Channel (RU)**](https://t.me/travisrunru)
* [**Telegram Channel (EN)**](https://t.me/travisrunfun)
* [**TRVS Token**](https://axiomechain.pro/token/axm1taerpmv0tzdrnls7z567khds88fwfpdaeeg7s0wkel9zjap7gnes95u3uw)
* [**TRVS / AXM Trading**](https://app.axiometrade.pro/ru/swap/AXM-TRVS)
### RED AND BLACK POKER
A gaming project within the Axiome ecosystem focused on card game / poker mechanics, competitive gameplay, and in-game engagement. Such products are important for the ecosystem as they create a distinct segment of users and activity - not infrastructure-driven or purely financial, but product-led and community-oriented. They strengthen network effects and increase the number of reasons for users to return to the ecosystem regularly.
* [**RBP Channel**](https://t.me/RedBlackPoker52)
* [**Play via BeatProject Bot**](https://t.me/pbeat_bot)
* [**RBP Chat**](https://t.me/RedBlackPokerchat)
* [**RBP Token**](https://axiomechain.pro/token/axm1hz3svgdhmv67lsqlduu0tcnd3f75c0xr0mu48l6ywuwlz43zssjqnua5v5)
* [**RBP / AXM Trading**](https://app.axiometrade.pro/ru/swap/AXM-RBP)
### **SHRIMP PEACE + SHRIMP DZEN**
A community- and meme-driven project within the Axiome ecosystem, with its own token, channel, audience, and recognizable brand. Shrimp Dzen acts as part of the same product funnel in the form of a Telegram Mini App / bot, helping drive engagement and retention. Together, they form not just a token, but a full-fledged community vertical at the intersection of meme culture, content, Telegram-native mechanics, and trading activity.
* [**Telegram Channel**](https://t.me/ShrimpsPeace)
* [**Telegram MiniApp**](https://t.me/ShrimpDzenBot)
* [**Community Chat**](https://t.me/+EapCtsLSKvc3NWEy)
* [**SHRIM Token**](https://axiomechain.org/token/axm13falgv7wf8v3pqcwhr7suvm8e8j0hu03fjmtwrh2vek2589tdazq5p0atj)
* [**SHRIM / AXM Trading**](https://app.axiometrade.pro/ru/swap/AXM-SHRIM)
### **SLUG**
A gaming vertical that fits naturally into the list of Axiome ecosystem projects as a consumer-facing product. It is another example of how the network is evolving not only through infrastructure and financial services, but also through a gaming environment designed for user retention, repeat engagement, and Telegram-native consumption.
* [**Telegram Channel**](https://t.me/SLUG_T0KEN)
* [**Play Slug Battle**](https://t.me/slug_battle_bot)
* [**SLUG Token**](https://axiomechain.pro/token/axm1nzvd5njkc0gqdezgzzqw00tu056rgxgwaqgq25g9ku0y5au3nwmqxqtr0l)
* [**SLUG / AXM Trading**](https://app.axiometrade.pro/ru/swap/AXM-SLUG)
### **BEAT PROJECT**
Play and earn AXM. This popular Telegram Mini App offers a wide selection of arcade games accessible via an AXM deposit. With the launch of Axiome Chain 2.0, the native token **$PBEAT** will be issued in the Axiome ecosystem and available for trading on Axiome Swap.
* [**Telegram Channel**](https://t.me/beatproject_ru)
* [**Telegram Bot**](https://t.me/pbeat_bot)
* [**Community Chat**](https://t.me/beat_project_chat)
### KEPY
A non-custodial wallet within the Axiome ecosystem for storing and managing AXM and all types of tokens issued on Axiome Chain. The Kepy team was the first to launch the USDT/USDB bridge, enabling the introduction of a stablecoin within Axiome Chain. USDB is the Kepy team’s stablecoin, backed 1:1 by real USDT TRC20 on the Tron network.
* [**Kepy Website**](https://kepy.io/)
* [**Telegram Channel**](https://t.me/kepyio)
* [**Support Bot**](https://t.me/kepyio_bot)
* [**KEPY Token**](https://axiomechain.pro/token/axm14vjqp6cq9mr90wzmqxsa5erx70h4xy5eep0jynjqmlstupngtghqspmr7q)
* [**KEPY / AXM Trading**](https://app.axiometrade.pro/ru/swap/AXM-KEPY)
### **AXIOME AI**
A service with its own user-friendly Telegram Mini App that brings together the best modern AI models, including Gemini, Imagen, and Veo. Access is paid in AXM by purchasing credits for requests.
{% embed url="" %}
### HUNTER NETWORK
Hunter Network is a matrix-based MLM product that actively leverages AXM and other ecosystem products in its mechanics. It has its own bots, a validator, and integrations with other Axiome ecosystem products.
* [**Hunter Network Bot**](https://t.me/Hunternetwork_bot)
* [**HUNT User Guide**](https://hunt-3.gitbook.io/hunt-ecosystem/yazyk-language/russkii)
# Support and contacts
## Support
Technical support assists Axiome users through Telegram for quicker responses.
* [In English and German](https://t.me/axiomesupport_en)
* [На русском](https://t.me/axiomesupport)
{% hint style="danger" %}
Be careful when starting a conversation with support. Make sure the Telegram account nicknames are **@axiomesupport** and **@axiomesupport\_en**.
\
Axiome support will never ask for your seed phrase or request that you transfer your AXM to any address.
{% endhint %}
## Our Emails
Collaboration offers: ****
Recommendations and feedback: ****
Marketing and advertising: ****
{% hint style="info" %}
**Important Links:**
🇬🇧 [Telegram in English](https://t.me/axiomeen)
🇷🇺 [Telegram на русском](https://t.me/axiomeru)
🇩🇪 [Telegram Auf Deutsch](https://t.me/axiomede)
[Twitter](https://twitter.com/axiome_pro)
[Axiome Pay ](https://axiomepay.com/en)- crypto cards
[Block Explorer](https://axiomechain.org/)
**Buy AXM:**
[On MEXC](https://www.mexc.com/exchange/AXM_USDT)
[On Biconomy](https://www.biconomy.com/exchange/AXM_USDT)
[On Tapbit](https://www.tapbit.com/spot/exchange/AXM_USDT?tab=USDT)
[P2P-bot](https://t.me/axiome_p2p_bot) (for users from Russia and Belarus)
[CoinMarketCap](https://coinmarketcap.com/currencies/axiome/)
[CoinGecko](https://www.coingecko.com/en/coins/axiome)
{% endhint %}
# Core Team
### Alex Scheck - Chief Executive Officer (CEO)
Founder and executive lead responsible for product strategy, ecosystem development, and partnerships.
[LinkedIn](https://www.linkedin.com/in/alex-scheck-19614b113/)
### Evgeny Sakirkin - Chief Technology Officer (CTO)
Leads blockchain architecture, core protocol development, and infrastructure engineering.
[LinkedIn](https://www.linkedin.com/in/esakirkin/)
### Yusuf Bilgic - Non-Executive Director (NED)
Provides strategic oversight, governance, and advisory support.
[LinkedIn](https://www.linkedin.com/in/yusuf-bilgic-66a32b5/)
### Charles Belford - Chief Risk and Trading Officer (CRTO)
Oversees risk management, trading strategy, and market operations.
[LinkedIn](https://www.linkedin.com/in/charles-g-belford-2086832/)
# Intro
Our blockchain are based on COSMOS-SDK and we do not see the need to duplicate documentation. We focus your attention and describe the features that distinguish us and give you a links to appropreate COSMOS docs
### For node operators
[Start blockchain node on Ubuntu](https://docs.axiomeinfo.org/how-to/start-blockchain-node-on-ubuntu)
[Become a validator](https://docs.axiomeinfo.org/how-to/become-a-validator)
### For blockchain developers
[Short overview](https://docs.axiomeinfo.org/axiome-blockchain/short-overview)
[Axiome Modules](https://docs.axiomeinfo.org/axiome-blockchain/axiome-modules)
### For frontend developers
axm-sign-js libiriary and docs will be placed here in the future
# Useful links
#### **Useful links to start development / integration with Axiome Chain:**
Autogenerated swagger docs for node REST:
Public gRPC REST gateway:
Axiome Node protobuf definitions:
Axiome Node source code: [https://github.com/axiome-pro/axm-node](https://github.com/axiome-pro/axm-node/tree/master)
Axiome Node prebuild binaries:
Docs for cosmos sdk client library (TS) - useful for frontend or JS/TS backend: , ,
#### Releases:
You can find all releases on our [GitHub](https://github.com/axiome-pro/axm-node/releases/).[ ](https://docs.axiomeinfo.org/how-to/add-extended-cw20-token-info)
# Start blockchain node on Ubuntu
## Start Node by axmd-install.sh Script
You can start the axm node using the `axmd-install.sh` automation script. This script performs the following steps:
* Downloads the latest version of the prebuilt `axm-node` binaries.
* Downloads the prebuilt version of `cosmovisor`.
* Downloads `cosmovisor.service` and copies it to `/etc/systemd/system/`.
* Initializes the node with the provided name.
* Sets up the directory structure and initializes node configuration files with recommended values.
* Downloads the genesis file and places it into `$DAEMON_HOME/config/genesis.json`.
* Downloads the latest binary blocks and places them into `$DAEMON_HOME/data/`.
Download the script from GitHub releases, change its permissions, and run:
```sh
curl -L -o axmd-install.sh https://github.com/axiome-pro/axm-node/releases/download/v1.0.3/axmd-install-1.0.3.sh
chmod 755 axmd-install.sh
./axmd-install.sh -m -h -r
```
Script parameters:
* `-m` - moniker name (i.e., your node name).
* `-h` - daemon home (where to place daemon config and data files). Also sets the `$DAEMON_HOME` variable for `cosmovisor`. Defaults to `~/.axmd/`.
* `-r` - specify to enable blockchain app legacy REST endpoints.
After running this script, you can check $DAEMON\_HOME and correct your config files as needed (for config parameters, look in Cosmos SDK and Comet BFT docs).
Now you can start the node by running the cosmovisor service:
```sh
systemctl start cosmovisor
```
P.S. You can safely remove `$DAEMON_HOME/data/blocks-latest.tar.gz` after start.
## Start node from scratch
First, you need to obtain binaries using one of two possibilities: get prebuilt binaries from our releases or build binaries from source codes. When binaries are ready, you can start the node using the genesis file (which takes longer), or download binary blocks and start from them.
### Get prebuilt binaries
Go to the [Releases](https://github.com/axiome-pro/axm-node/releases/) section of GitHub
Download appropriate file and move to `/usr/local/bin`
```sh
curl -L -o axmd https://github.com/axiome-pro/axm-node/releases/download/v1.0.1/axmd-linux-amd64-1.0.1
chmod 755 axmd
mv axmd /usr/local/bin
```
### Build from sources
Make sure you have Docker installed.
Download this repo and check out v1.0.0 version with
```sh
git clone https://github.com/axiome-pro/axm-node.git -b v1.0.1
```
Build the application with make
```sh
make build-all
```
Copy a built binary from the builds directory to somewhere your OS could find it (i.e. some directory in a `$PATH`)
```sh
cp build/linux_amd64/axmd /usr/local/bin/axmd
```
### Starting node from genesis file
Initialize your node with
```sh
axmd init [moniker] where [moniker] is a name you like.
```
Replace a just created genesis file (`$HOME/.axmd/config/genesis.json` by default) with one downloaded from
Validate genesis file sha256 checksum (`efa132483274106bfbf425db2912218ed3219a6065491d73dc79abeba076be30`)
In the node configuration file (`$HOME/.axmd/config/config.toml` by default) set peers, seeds and consensus parameters:
```toml
persitent_peers = ""
seeds = "eaxmple@eaxmple.com"
timeout_propose = "3s"
timeout_propose_delta = "500ms"
timeout_prevote = "1s"
timeout_prevote_delta = "500ms"
timeout_precommit = "1s"
timeout_precommit_delta = "500ms"
timeout_commit = "5s"
```
Start node with
```sh
axmd start
```
The node will download and replay blocks, it may take a while.
### Additional: starting node with binary block data (for faster syncing)
Download latest binary blocks archive from our CDN to empty `$HOME/data/` directory and extract it
```shell
curl -L -o latest.tar.gz https://axiome.fra1.cdn.digitaloceanspaces.com/blocks/blocks-latest.tar.bz2
tar -xzf latest.tar.gz
```
then you can run `axmd` as usual
> Blocks for 1.0.3:
>
> Blocks for 1.0.2:
>
> Blocks for 1.0.1:
# Become a validator
First of all you need to install, run and sync node, using [this instruction](/developer-documentation/start-blockchain-node-on-ubuntu).
> **Validation Requirements:**
>
> * Your account must be registered in the x/referral module to delegate and start validation (you can send 1 AXM to another validator using the mobile app or send a register-referral tx from the axm node CLI).
> * You need at least 23 529.411765 AXM in the main wallet to delegate to your own validator with a create-validator tx (you receive 20 000 AXM to the delegation balance because this amount will be decreased by 15% due to partner commissions payout).
> * At least a 4-core modern CPU (desktop or server line, not mobile solutions).
> * 16+ GB RAM.
> * NVMe SSD 500+ GB (Blockchain grows around 1-2GB per week).
> * 50+ Mbit/s low-latency network.
>
> P.S. We can change these hardware requirements due to blockchain and node network growth as we accumulate more real usage statistics.
We strongly recommend to read following article to undestend how Comet BFT network building concept.
Then you need an account with at least 23 529.411765 AXM to delegate and start the node. Also, you need to add the key of your account to run necessary commands.
```sh
axmd keys add --recover
```
Remark: This manual assumes your node binary is available on `$PATH` and `DAEMON_HOME` is set to its default location (`$HOME/.axmd`).
Now you need to create a JSON file with validator configuration (`validator.json` or something you like):
```json
{
"pubkey": {"@type":"/cosmos.crypto.ed25519.PubKey","key":""},
"amount": "",
"moniker": ""
}
```
Where:
* `your-validator-key` is the validator key from the `axmd comet show-validator` command output.
* `your-staking-amount` is the initial self-stake of the validator in uaxm (must be 20 000 000 000 uaxm or higher. Don't forget about the x/referral module commission - use not less than 23 529 411 765 uaxm).
* `moniker` is your node's public name (shown in the app's staking list, changing this name costs tokens).
Now, send a transaction to create your validator and start signing blocks:
```sh
axmd tx staking create-validator validator.json --from --gas auto --gas-adjustment=1.45 --gas-prices=1.7uaxm --chain-id axiome-1
```
Wait a few seconds for the transaction to be processed. Now your validator is running. You can check it in the validators list by running:
```sh
axmd q staking validators
```
Additional information can be found in Cosmos SDK `x/staking` and `x/distribution` modules docs
> **Important note:** If you are preparing to become a validator, please contact us on [Telegram](https://t.me/axm_node_support) (we work with requests from 11:00 to 14:00 Central European Time). We will add you to the validators community group for better coordination of work, and if necessary, we will provide advisory support.
# Join the Devnet
The **Devnet** is a public development network designed for testing new features, experimenting with smart contracts, and onboarding validators or developers — all without risking real assets.
It closely mirrors the mainnet environment, but with shorter block times, more relaxed parameters, and easier access to tokens for testing.
Use the Devnet to:
* Deploy and test CosmWasm smart contracts
* Interact with on-chain modules in a safe sandbox
* Validate node configuration before mainnet launch
* Report bugs and help improve the Axiome Chain
Whether you're a developer, validator, or just curious, Devnet is the ideal place to get started.
{% hint style="info" %}
This tutorial assumes that you understand how to [run an Axiome blockchain node](/developer-documentation/start-blockchain-node-on-ubuntu) and provides only a short tip for working with the devnet.
{% endhint %}
## How to Run a Devnet Node
Follow these steps to set up and run a node connected to the Axiome Devnet.
#### **1. Download the Devnet Build**
Download the latest version of the Devnet node binary from links below.
Linux x86\_64:
{% embed url="" %}
You also need to download the **`libwasmvm` shared library**, which is required for CosmWasm support.
> ⚠️ Make sure to place `libwasmvm.x86_64.so` in a location accessible by your system (e.g., `/usr/lib/` or `/usr/local/lib/`), and run `ldconfig` if necessary.
{% embed url="" %}
***
#### **2. Get the Genesis File**
Download the current `genesis.json` file from the provided link. At this step, we assume that the node has already been initialized with `axmd init ` and that your keys have been imported using `axmd keys add --recover`.
{% embed url="" %}
And place it in your node’s configuration directory, usually located at:
```sh
~/.axmd/config/genesis.json
```
***
#### **3. Configure the Node**
Open your `config.toml` file (typically located at `~/.axmd/config/config.toml`) and set the following:
* **Persistent peers** – a list of stable nodes to connect with.
* **RPC / P2P ports** – ensure they don’t conflict with other services.
Currently our devnet peer is:
```sh
persistent_peers = "244c09ddc4e2cbeeb32e1ac9437eb9e5beed7973@206.189.115.37:26656"
```
***
#### **4. Start the Node**
Run the node using the downloaded binary:
```sh
./axmd start
```
If everything is configured correctly, your node should sync with the Devnet.
***
#### **(Optional) Create a systemd Service**
To run your node as a background service and start it automatically on boot, you can create a `systemd` unit file:
```sh
sudo nano /etc/systemd/system/axmd.service
```
Paste the following (update paths as needed):
```toml
[Unit]
Description=Axmd+Wasm service
After=multi-user.target
StartLimitIntervalSec=0
[Install]
WantedBy=multi-user.target
[Service]
WorkingDirectory=
Environment="DAEMON_HOME="
Environment="DAEMON_NAME=axmd"
Environment="DAEMON_ALLOW_DOWNLOAD_BINARIES=true"
Environment="DAEMON_RESTART_AFTER_UPGRADE=true"
Environment="DAEMON_DATA_BACKUP_DIR=/mnt/axm"
Environment="UNSAFE_SKIP_BACKUP=true"
Type=simple
Restart=always
RestartSec=60
User=root
LimitNOFILE=262144
ExecStart=/axmd start
StandardOutput=append:/var/log/axmd-wasm.log
StandardError=append:/var/log/axmd-wasm.log
```
Then enable and start the service:
```sh
sudo systemctl daemon-reexec
sudo systemctl enable axmd
sudo systemctl start axmd
```
# Deploy a Smart Contract on Devnet
This guide walks you through uploading, instantiating, and interacting with a CosmWasm smart contract on the Axiome Devnet. You can find the full CosmWasm documentation [here](https://cosmwasm.cosmos.network/).
## **Requirements**
Before you begin, make sure you have:
* A running **Devnet node** (or access to one via RPC)
* The **CosmWasm contract** compiled to `.wasm` (e.g., via `cargo run-script optimize`)
* The **CLI binary** (`axmd`) installed
* A **key** with testnet tokens (use a faucet if needed)
***
#### **Step 1: Create or Recover a Wallet**
```sh
axmd keys add mykey
# or recover
axmd keys add mykey --recover
```
***
#### **Step 2: Request Test Tokens**
Find you address:
```sh
axmd keys show mykey -a
```
And go to our faucet to get tesnet AXM tokens (only 5000 per day per address)
***
#### **Step 3: Upload the Contract**
```sh
axmd tx wasm store path/to/contract.wasm \
--from mykey \
--gas auto --gas-adjustment 1.3 \
--fees 5000uaxm \
-y
```
> This transaction returns a **code ID** — you'll need it for the next step.
To check the list of uploaded contracts:
```sh
axmd query wasm list-code
```
***
#### **🏗️ Step 4: Instantiate the Contract**
```sh
axmd tx wasm instantiate '{"field":"value"}' \
--from mykey \
--label "my contract" \
--admin $(axmd keys show mykey -a) \
--gas auto --gas-adjustment 1.3 \
--fees 5000uaxm \
-y
```
> 📌 Replace `{"field":"value"}` with your contract's init message.
To get the contract address:
```sh
axmd query wasm list-contract-by-code
```
***
#### **⚙️ Step 5: Interact with the Contract**
Example execution:
```sh
axmd tx wasm execute '{"action":"value"}' \
--from mykey \
--gas auto --gas-adjustment 1.3 \
--fees 5000uaxm \
-y
```
Example query:
```sh
axmd query wasm contract-state smart '{"query":{}}'
```
# Sign a Smart Contract Call with Axiome Connect
Axiome Connect allows you to securely **sign smart contract calls** from external applications using either an authorization code or a QR code.
This is useful for integrating web apps, bots, or scripts with your wallet in a secure and interactive way.
***
### **Step 1: Prepare the JSON Payload**
Create a JSON object describing the smart contract call you want to sign. Here's an example for a token swap:
```json
{
"type": "cosmwasm_execute",
"network": "axiome-devnet",
"contract_addr": "axm14hj2tavq8fpesdwxxcu44rty3hh90vhujrvcmstl4zr3txmfvw9sletw5k",
"funds": [
{
"denom": "uaxm",
"amount": "1000000"
}
],
"msg": {
"swap": {
"input_token": "Token1",
"input_amount": "1000000",
"min_output": "800000"
}
},
"memo": "test memo"
}
```
***
### **Step 2: Encode to Base64 and Prefix**
Encode the JSON as a Base64 string (without line breaks or padding), then prefix it with `axiomesign://`.
Example in JavaScript:
```javascript
const payload = { /* your JSON here */ };
const base64 = Buffer.from(JSON.stringify(payload)).toString('base64');
const finalString = `axiomesign://${base64}`;
console.log(finalString);
```
***
### **Step 3: Use Axiome Connect**
You have **two options** to sign the transaction:
#### **Option 1: Paste the string**
Paste the `axiomesign://...` string into the input field of **Axiome Connect** in your Axiome Wallet app (starting from version 2.1.12 in iOS and 2.0.56 in Android)
Press **Connect** — your app will decode the payload and ask you to **sign** the transaction.
***
#### **Option 2: Scan a QR Code**
You can also encode the `axiomesign://...` string into a **QR code** and scan it directly from the Axiome Connect mobile app.
> You can use any QR generator — just make sure the encoded string starts with `axiomesign://` and contains the full base64-encoded payload.
***
**Notes**
* `contract_addr` must be a valid CosmWasm contract address on the selected network.
* `funds` is optional if the contract call doesn’t require tokens.
* `memo` is optional and can be used for tagging or tracking.
* The app will preview the decoded message before signing.
# Add Extended CW20 Token Info
You can enhance your CW20 token with rich metadata such as website, social links, full description, images, and legal/audit info — stored off-chain and referenced from `marketing_info.project` in your smart contract.
***
### Step 1: Prepare Extended Metadata
The extended metadata must be stored as a JSON file hosted on a publicly accessible URL. The URL will be placed in the CW20 `marketing_info.project` field **with SHA-256 checksum verification** to ensure data integrity.
**JSON Format Specification**
Here is the approved format of the metadata file:
```json
{
"version": "1.0",
"name": "MyToken",
"symbol": "MTK",
"website": "https://mytoken.example.com",
"description": {
"format": "markdown",
"image_url": "https://mytoken.example.com/images/logo-large.png",
"video_url": "https://www.youtube.com/@axiome_ru",
"content": [
{
"language": "en",
"text": "Full token description in markdown or plain text, no more then 60k symbols..."
},
{
"language": "de",
"text": "Vollständige Token-Beschreibung in Markdown- oder Klartextformat, nicht mehr als 60.000 Zeichen …"
}
}
},
"socials": {
"X (ex. Twitter)": "https://twitter.com/mytoken",
"Telegram": "https://t.me/mytokenchat",
"Discord": "https://discord.gg/mytoken",
"GitHub": "https://github.com/mytoken"
},
"legal": {
"terms_url": "https://mytoken.example.com/terms",
"privacy_url": "https://mytoken.example.com/privacy"
},
"audit": [
{
"provider": "Certik",
"url": "https://certik.com/projects/mytoken",
"date": "2024-12-01"
}
],
"contacts": {
"email": "contact@mytoken.example.com",
"support_url": "https://mytoken.example.com/support"
}
}
```
**Notes:**
* `description.format` must be either `"markdown"` or `"text"`
* any fields except `version`, `name`, `symbol` can be set to `null` if not used
* `socials` can include any keys (e.g., TikTok, Instagram, etc.)
* `description.content` can contain either a string or an array of objects:
* If a string is provided, it will be used directly as the token description.
* If an array of objects is provided, each object must have the following structure:\
`{ "language": "<2-letter code>", "text": "" }`.\
In this case, the application or explorer will select the most appropriate translation based on the user’s selected language.\
The selection algorithm is as follows:
1. Attempt to find a translation matching the user’s language using a two-letter language code according to **ISO 639-1**.
2. If no matching language is found, attempt to use the `en` (English) translation.
3. If `en` is not available, use the first translation in the list.
***
### Step 2: Calculate SHA-256
To ensure the metadata has not been tampered with, calculate its **SHA-256 checksum** (of the raw file content).
**On Linux/macOS:**
```json
curl -s https://cdn.example.com/exmpl.json | sha256sum
```
**On Windows (PowerShell):**
```powershell
Invoke-WebRequest -Uri "https://cdn.example.com/exmpl.json" -UseBasicParsing | % Content | `
Out-File -Encoding ascii -FilePath metadata.json
Get-FileHash metadata.json -Algorithm SHA256
```
Suppose the result is:
```
aabbccddeeff00112233445566778899aabbccddeeff00112233445566778899
```
***
### Step 3: Upload Project Info to the Contract
CW20 contracts support setting `marketing_info.project` with a URL that includes the `sha256sum` as a query parameter.
**Example `axmd` TX to set the project info:**
```sh
axmd tx wasm execute '{
"update_marketing": {
"project": "https://cdn.example.com/exmpl.json?sha256sum=aabbccddeeff00112233445566778899aabbccddeeff00112233445566778899"
}
}' \
--from \
--gas auto --gas-adjustment 1.3 --fees 5000uaxm \
--chain-id demo
```
Replace:
* `` — with the CW20 contract address
* `` — with your wallet (keyring) name
***
#### Done!
Once the transaction is confirmed, your token will have a verifiable extended metadata link accessible via `marketing_info.project`.
Axiome Wallet, Axiome Explorer, and dApps can parse this JSON and render:
* Full token details
* Social links
* Brand image/video
* Contact and legal info
# Axiome Trade Contract API
This document describes the public interface of the AMM contract for integration with third‑party applications and services. Message examples are provided in JSON format — exactly as they are sent to
## Notation and conventions
* Token denomination: a discriminator object indicating the type of asset. Exactly one of the following forms is used in requests/responses:
* Native coin of the chain: `{ "native": "" }`
* CW20 token: `{ "cw20": "" }`
* Numeric fields:
* Amounts are strings with integer values in minimal units (e.g., `uatom`, `uosmo`, etc.). No separators.
* Fee percentages are decimal fractions in the inclusive range \[0, 1], also passed as strings (e.g., "0.003" = 0.3%).
* Unless explicitly stated otherwise, all amounts are unsigned and specified in minimal units of their denomination.
## Queries (QueryMsg)
The contract supports the following queries. Each entry lists its purpose, request structure, and expected response.
{% stepper %}
{% step %}
### Balance { address }
* Purpose: LP token balance (the contract’s LP token implements CW20 standard).
Request message:
```
{ "balance": { "address": "wasm1...user" } }
```
Response (standard CW20):
```
{ "balance": "" }
```
{% endstep %}
{% step %}
### Info {}
* Purpose: aggregated pool information — reserves, denominations, LP token address and total supply.
Request message:
```
{ "info": {} }
```
Response:
```
{
"token1_reserve": "",
"token1_denom": { "native": "..." },
"token2_reserve": "",
"token2_denom": { "cw20": "..." },
"lp_token_supply": "",
"lp_token_address": "wasm1...lp"
}
```
Notes:
* `token*_denom` are discriminator objects. Only one key is present: either `native` or `cw20`.
{% endstep %}
{% step %}
### Token1ForToken2Price { token1\_amount }
* Purpose: get a quote — how much of token2 you will receive for a given amount of token1, accounting for current pool state and fees.
Request message:
```
{ "token1_for_token2_price": { "token1_amount": "1000000" } }
```
Response:
```
{ "token2_amount": "" }
```
{% endstep %}
{% step %}
### Token2ForToken1Price { token2\_amount }
* Purpose: reverse quote — how much of token1 you will receive for a given amount of token2.
Request message:
```
{ "token2_for_token1_price": { "token2_amount": "1000000" } }
```
Response:
```
{ "token1_amount": "" }
```
{% endstep %}
{% step %}
### Fee {}
* Purpose: current fee settings and owner (if set).
Request message:
```
{ "fee": {} }
```
Response:
```
{
"owner": "wasm1..." ,
"lp_fee_percent": "",
"protocol_fee_percent": "",
"protocol_fee_recipient": "wasm1...recipient"
}
```
Notes:
* `owner` may be absent/null depending on the deployment; treat accordingly in your client.
{% endstep %}
{% endstepper %}
## How to obtain a swap price
Depending on the direction, use one of the two pricing queries:
* Price Token1 -> Token2:
```
{ "token1_for_token2_price": { "token1_amount": "" } }
```
Response:
```
{ "token2_amount": "" }
```
* Price Token2 -> Token1:
```
{ "token2_for_token1_price": { "token2_amount": "" } }
```
Response:
```
{ "token1_amount": "" }
```
Both quotes are computed by the contract based on the current pool reserves and fee settings (`lp_fee_percent`, `protocol_fee_percent`).
## How to obtain pool reserves and metadata
Call `Info`:
```
{ "info": {} }
```
Check `token1_reserve`, `token2_reserve`, and the denominations `token1_denom`, `token2_denom`. You will also receive the LP token address (`lp_token_address`) and its total supply (`lp_token_supply`).
As a rule of thumb, the spot price is approximately `token1_reserve / token2_reserve` (depending on which way you quote).
## How to obtain current fees
Call `Fee`:
```
{ "fee": {} }
```
The response includes the pool fee percentage and the protocol fee recipient. Percentages are fractions of 1 (e.g., "0.01" = 1%).
## Instantiate message
Message for deploying the contract. Fields and their meaning:
`InstantiateMsg`:
```
{
"token1_denom": { "native": "..." },
"token2_denom": { "cw20": "..." },
"lp_token_code_id": ,
"owner": "wasm1...",
"protocol_fee_recipient": "wasm1...",
"protocol_fee_percent": "",
"lp_fee_percent": ""
}
```
Notes:
* `token1_denom`, `token2_denom` — the assets that form the trading pair. Each is a discriminator object with either `native` or `cw20` key.
* `lp_token_code_id` — code ID of the CW20 contract used to mint the pool’s LP token.
* `owner` — admin address (may be null/omitted). Has the right to update fee parameters and owner.
* `protocol_fee_recipient` — recipient of the protocol fee (e.g., community pool).
* `protocol_fee_percent` — protocol fee share (0..1).
* `lp_fee_percent` — pool fee share (0..1).
## Execute messages (ExecuteMsg) — brief
Below are the key execute commands. Full field formats follow the contract schema and examples. If a parameter is marked optional (?), it may be omitted.
* add\_liquidity { token1\_amount, min\_liquidity, max\_token2, expiration? }
* Adds liquidity to the pool. `min_liquidity` protects against adverse slippage; `max_token2` caps the counter‑asset deposit.
* remove\_liquidity { amount, min\_token1, min\_token2, expiration? }
* Burns LP tokens and withdraws the share of reserves. Minimums protect against slippage.
* swap { input\_token: "token1"|"token2", input\_amount, min\_output, expiration? }
* Standard swap. `min_output` is a slippage guard: actual output cannot be less.
* pass\_through\_swap { output\_amm\_address, input\_token, input\_token\_amount, output\_min\_token, expiration? }
* Pass‑through swap using another AMM as the next hop. Useful for 2+ pool routes.
* swap\_and\_send\_to { input\_token, input\_amount, recipient, min\_token, expiration? }
* Swap and then send the result to the specified address (e.g., payouts to a user/contract).
* update\_config { owner?, lp\_fee\_percent, protocol\_fee\_percent, protocol\_fee\_recipient }
* Update fee parameters and owner. Requires owner privileges.
* freeze\_deposits { freeze }
* Enable/disable accepting new liquidity deposits (administrative).
{% hint style="warning" %}
Security notes:
* It is recommended to always set `min_*` parameters and `expiration` to avoid MEV/slippage and stale quotes.
* For CW20 operations, you may need to perform `approve`/`increase_allowance` per the CW20 standard, depending on your execution environment.
{% endhint %}
## Quick query examples
* Pool reserves:
```
{ "info": {} }
```
* Price 1 -> 2 for 1 minimal unit:
```
{ "token1_for_token2_price": { "token1_amount": "1" } }
```
* Fees:
```
{ "fee": {} }
```
* LP balance for an address:
```
{ "balance": { "address": "wasm1...user" } }
```
## Errors and general recommendations
* If input parameters are invalid (e.g., negative values, zero amounts, denomination mismatch), the contract will return an execution error and the transaction will be reverted.
* With low liquidity, the price query may return very small outputs; use `min_*` guards in execute messages.
* To assess slippage, first call the corresponding price query, then form the execute message with a reasonable margin.
## Compatibility and versions
* Message formats are compatible with the CosmWasm ecosystem and assume the standard mechanisms of sending queries/transactions through the network’s RPC/REST services.
* When upgrading the contract, follow the project’s changelog and verify whether field names or semantics have changed.