ALYX Mainnet Developer Portal

ALYX Mainnet Public Network and API Documentation

Official technical reference for ALYX mainnet, including network identity, public API routes, RPC/LCD access, DEX markets, Gecko-style market data, TokenFactory assets, AI execution, metadata files, liquidity locks, and listing integration endpoints.

ALYX is a Cosmos SDK + CometBFT non-EVM Layer-1 focused on autonomous intelligence, on-chain liquidity, TokenFactory assets, and ALYX-denominated execution.

1. Listing Verification Notice

This page is intended for exchanges, explorers, CoinMarketCap, CoinGecko, GeckoTerminal, wallets, indexers, validators, and integration partners reviewing ALYX mainnet.

2. Market Data / Gecko Adapter for Listings

ALYX exposes Gecko-style market data routes for CoinGecko, GeckoTerminal, CoinMarketCap, explorers, and indexers. Pair IDs use the format alyx-{poolId}. 

curl -s https://alyxai.org/api/gecko/latest-block | jq .
curl -s https://alyxai.org/api/gecko/assets | jq .
curl -s https://alyxai.org/api/gecko/pairs | jq .
curl -s https://alyxai.org/api/gecko/pairs/alyx-1 | jq .
curl -s https://alyxai.org/api/gecko/events | jq .

Current live pair mapping:

Compatibility fields such as reserve_usd and volume_usd_24h are ALYX-normalized until an external USD oracle or market reference is added. Native values are exposed as reserve_alyx, volume_alyx_24h, and price_native.

3. Network Identity

4. Base URLs

5. Mainnet Public Infrastructure

ALYX mainnet is supported by primary and multi-node backup RPC/API infrastructure. These endpoints are intended for wallets, explorers, validators, indexers, applications, and external integrations building on alyx-1.

Primary RPC/API

Backup Node 2

Backup Node 3

Recommended integration pattern: use the primary RPC/API endpoints by default and fail over to backup node 2 or backup node 3 if the primary endpoint is unavailable. 

Primary:
RPC: https://rpc.alyxai.org
API/LCD: https://api.alyxai.org

Backup Node 2:
RPC: https://rpc2.alyxai.org
API/LCD: https://api2.alyxai.org

Backup Node 3:
RPC: https://rpc3.alyxai.org
API/LCD: https://api3.alyxai.org

6. Core Public API Routes

7. Network Overview Example

GET https://alyxai.org/api/network/overview

Expected identity:
{
  "chainId": "alyx-1",
  "totalSupply": "3,000,000,000",
  "genesisSupply": "3000000000"
}

8. DEX

ALYX mainnet includes a native on-chain DEX module using a constant-product AMM model. ALYX is the monetary hub asset for all core markets. 

GET https://alyxai.org/api/dex/params

Expected mainnet fee routing:
{
  "swapFeePercent": 0.3,
  "feeSplitPercent": {
    "lp": 0.15,
    "validators": 0,
    "treasury": 0.15
  }
}
GET https://alyxai.org/api/dex/pools

Mainnet live pools include:
- Pool 1: ALYX / AI
- Pool 2: ALYX / GPU
- Pool 3: ALYX / DATA
- Pool 4: ALYX / MODEL
- Pool 5: ALYX / DeltaWolves

9. On-Chain Liquidity Locks

ALYX supports protocol-native LP liquidity locks through the DEX module. Mainnet liquidity is locked on-chain and can be verified through DEX pool data and gRPC queries. 

curl -s https://alyxai.org/api/dex/pools | jq '.[] | {
  poolId,
  pair,
  hasLockedLiquidity,
  isForeverLocked,
  lockSummary
}'

10. Asset Classification

Assets may scale upward based on verifiable on-chain ALYX liquidity. No asset becomes canonical except ALYX.

11. TokenFactory Assets

GET https://alyxai.org/assetlist.json
GET https://alyxai.org/api/tokenfactory/assetlist
GET https://alyxai.org/api/tokenfactory/metadata

12. AI Layer

ALYX exposes public AI module routes for model registry, pricing, execution metadata, and paid execution flows. AI execution is denominated in ALYX. 

GET https://alyxai.org/api/ai/pricing

13. Validator Integration

Mainnet validators must use alyx-1. Testnet instructions for alyxtest-4 must not be used for mainnet validators. 

CHAIN_ID=alyx-1 curl -s https://raw.githubusercontent.com/AlyxAIf/alyx-validator/main/scripts/install-validator.sh | bash

14. Integration Verification

curl -s https://alyxai.org/api/health | jq .
curl -s https://alyxai.org/api/network/overview | jq '.chainId, .totalSupply'
curl -s https://alyxai.org/chain.json | jq '.chain_id, .network_type'
curl -s https://alyxai.org/keplr-chain.json | jq '.chainId'
curl -s https://alyxai.org/assetlist.json | jq '.assets | length'
curl -s https://alyxai.org/api/dex/pools | jq 'length'
curl -s https://alyxai.org/api/gecko/pairs | jq '.data | length'

15. Mainnet / Testnet Separation

Backend data is the source of truth. Domain identity must always match the network it represents. Mainnet APIs should not point to testnet data, and testnet APIs should not point to mainnet data.

16. Official Contact