📝Self-Service Listing

Create your own pool and make your token tradeable on ALEX decentralized exchange in simple steps!

Supported Tokens: ALEX Self-Service Listing currently supports Stacks Chain Tokens (SIP-010 Standard Token).

🚀 Getting Started

How it works?

Self-Service Listing allows you to create your own liquidity pool on the ALEX DEX, enabling the permissionless trade of the listed token with an anchor token within the exchange. The anchor token is typically one with a stable value, providing a reliable reference point for defining the price of the newly listed token.

Pool creation usually takes between 24 to 48 hours. Once the pool is created and live, the price discovery phase begins: users can start trading the listed token against the anchor token and viceversa. Users interested in providing liquidity can contribute to the pool like any other ALEX pool.

The pool owner is the initial liquidity provider and will receive the corresponding LP tokens upon successful pool creation. Once the pool is live and operational, the owner can withdraw funds just like any other liquidity provider.

Avaiblable Anchor Tokens: Native STX token, ALEX token and aBTC token.

The trading pool operates under the ALEX Automated Market Maker (AMM) algorithm, which dynamically determines the exchange rate (price) based on the trades.

Minimum requirements

👉 Token Deployment. Ensure your token is deployed on the Stacks blockchain, as you will need to provide the token contract.

👉 Select an Anchor Token. Choose an anchor token from the available options: Stacks native token STX, ALEX token, or aBTC token. Ensure you have at least 1,800 STX or an equivalent value in ALEX or aBTC token to create the pool—this is the minimum anchor token liquidity.

👉 Determine Initial Price. Decide the initial price for your listing token in terms of anchor token units. This should answer the question: how many anchor tokens do users need to buy one listed token?

👉 Calculate Initial Liquidity. Once the initial price is determined, you can set the initial liquidity amounts for both tokens in the pool. You may calculate this manually or use the ALEX Lab UI for assistance. If you're planning to add farming to the pool, make sure to reserve enough tokens for farm rewards.

Manual calculation example (price, ratio, and initial amounts)

Let's suppose you choose STX as the anchor token and want to provide 4,000 STX as the initial anchor token liquidity.

To determine the price, you will need to decide how many STX equals 1 of your listing token. In other words, decide how many STX users will need to buy 1 listed token. Let's say you set the price of your token at 0.5 STX.

To calculate the initial liquidity for the listed token, you need to divide the anchor token amount by the price. This is 4,000 STX / 0.5 STX = 8,000, resulting in the initial amount for the listed token.

The liquidity pool for the pair Listed Token 🚀 - Anchor Token ⚓ will have an initial ratio of 2:1. This ratio is calculated as the minimal expression of the fraction 8,000 / 4,000 (initial listed token amount slash initial anchor token amount).

🔎 For more details, check the FAQs section.

With that said, let's get hands-on!

🛠️ Procedure

Step 0: Go to Self-Service Listing page

Head to the Self-Service Listing page at the ALEX Lab App. Alternatively, you can access it via the app.alexlab.co homepage by navigating to the Swap -> Pool tab. Once on the Pool main page, hit the + Create button and select the Creating a new pool option.

Step 1: Submit token information & deposit the anchor token

In this step, you will set up the pool trading pair and configuration parameters. As part of this same transaction, you will transfer the anchor token's initial liquidity 💰 ⚓.

Step 1.1: Input the SIP-10 token contract address

Provide the listed token contract address. Ensure it complies with the SIP-010 Fungible Token Standard trait. In the example, the contract address is SP108J6F4C7JD93BGJ91TEB5D3CFB5XW39QHDJ3MV.rabby-token.

Step 1.2: Confirm token information provided by the contract

Verify that the token information retrieved from the contract is correct. In the example:

• Token name -> RABBY Token

• Token symbol -> RABBY

• Description -> Unlock the potential of programmable adventures within Bitcoin's rabbit holes.

• Token deployment address -> SP108J6F4C7JD93BGJ91TEB5D3CFB5XW39QHDJ3MV

• Token logo

Step 1.3: Set the initial liquidity and price

Enter the initial balances for both tokens. You can experiment with different amounts to observe how the exchange rate changes, though we recommend calculating these values beforehand.

In the screenshot example, this is:

• Anchor Token ⚓ (a.k.a token-x) -> 4,000 STX ($7,200)

• Listing Token 🚀 (a.k.a token-y) -> 200,000 RABBY

• Exchange Rate ⚖️ -> 1 RABBY = 0.02 STX ($0.03)

Once the pool opens, the AMM algorithm will automatically rebalance the exchange rate as users trade the tokens.

Step 1.4: Advanced pool settings (optional)

This step is optional, as the default settings are usually sufficient. If you have questions to ask before customization, reach out via Discord or Telegram.

Step 1.5: Submit transaction

Keep in mind that as part of this same transaction, you will transfer the anchor token's initial liquidity. By confirming the transaction, you are accepting the transfer of specific amount of anchor tokens from your wallet to the ALEX smart contract.

Click Submit and scroll through the wallet transaction window, ensuring the parameters and transfer amount are correct. If everything looks good, confirm the transaction on your wallet. This will allow your wallet to sign and broadcast the transaction.

Recommended to track transaction status:

• Turn on Telegram notifications, you will get notified when the transaction is confirmed.

• Search for the transaction on the ALEX Explorer.

• Check your address activity on the wallet.

Step 2: Contract creation

Once the transaction from Step 1 is completed, you will see the checkbox labeled Deposit Anchor Token ✅ marked as done. The ALEX team will review the submitted information and create a specific contract (a wrapped version) for your token to interact with the AMM DEX. This process may take between 24 and 48 hours.

Step 3: Deposit listing token

Once the Contract ready ✅ checkbox is marked as done, you're ready to deposit the listing token balance. This step involves interacting with a smart contract, so be sure to review the transaction details, paying particular attention to the amount to transfer. By accepting this transaction, you agree to transfer the initial liquidity of the listing token from your wallet to the ALEX smart contract.

Step 4: Pool creation success

Once the Deposit Listing Token ✅ transaction is completed and the Open pool ✅ checkbox is marked as done, your pool will be automatically ready for use. The new pool will appear as an ALEX Pool under the Self Listed tab on app.alexlab.co/pool.

🤝 After completing this step, you (and everyone) can start trading the token pair on ALEX DEX 🤝

Pool creation successful.

If you have added a custom start-block configuration, the pool will be unavailabe until that block is reached.

Step 5: Provide additional token information (optional)

To make your token visible on the ALEX Token List at app.alexlab.co/token-list, provide additional token information. Click on Customer Support on the Self-Service Listing page or contact us via Telegram at t.me/ALEXselfservice to submit the information (e.g. X accont, Discord, official website).

Token List example.

ALEX requires a Coingecko or CoinMarketCap token listing to verify the provided social media information before uploading it to the official list at app.alexlab.co/token-list.

Thanks for creating your pool on the ALEX DEX 🎉 📈