ALYX Developer Portal v1

ALYX Public Network and API Documentation

Public technical reference for the ALYX blockchain, including network identity, public infrastructure, seed nodes, RPC/API/gRPC endpoints, DEX surfaces, TokenFactory metadata, and AI execution routes.

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

Listing Verification Notice

ALYX is submitting an official listing request to CoinMarketCap.

All official project information, infrastructure endpoints, and public documentation originate from https://alyxai.org.

Official contact: listing@alyxai.org

2. System Description

ALYX = execution layer
DEX = price discovery
AI = value capture

ALYX uses a hub-and-spoke market structure with ALYX as the monetary coordination asset. Canonical ecosystem assets are priced in ALYX through live on-chain liquidity. AI is a premium ecosystem asset priced in ALYX through the ALYX/AI pool, while GPU, DATA, and MODEL are canonical economy assets with their own ALYX liquidity pairs.

3. Base URLs

Website: https://alyxai.org
Primary API: https://alyxai.org/api
Primary RPC: https://alyxai.org/rpc
Primary LCD: https://alyxai.org/lcd
Explorer: https://alyxai.org
Token Images: https://alyxai.org/assets/tokens/

4. Public Infrastructure Endpoints

Redundancy: ALYX public infrastructure is distributed across multiple independent nodes. Primary and backup endpoints are provided for reliability, fault tolerance, and seamless failover.

RPC

Primary RPC: https://rpc.alyxai.org
Backup RPC: http://rpc2.alyxai.org:26657
Primary Website RPC Path: https://alyxai.org/rpc

REST / LCD / API

Primary API: https://api.alyxai.org
Backup API: http://api2.alyxai.org:1317
Primary Website API Path: https://alyxai.org/api
Primary Website LCD Path: https://alyxai.org/lcd

gRPC (Cosmos Service Layer)

Used for Cosmos SDK queries, indexing, and advanced client integrations.

Primary gRPC: grpc.alyxai.org:9090
Backup gRPC: grpc2.alyxai.org:9090

Seed Nodes

Primary Seed: 150de304a7f498bd10d68f9fe6698a6a7addd48f@seed.alyxai.org:26656
Backup Seed: cf242dd238a236074d8551d2fe04f6e8f409a6a3@seed2.alyxai.org:26656

Direct IP Fallback

Node 1: 46.224.111.93
Node 2: 204.168.242.67

# Validator / full node persistent peers or seeds example
seeds = "150de304a7f498bd10d68f9fe6698a6a7addd48f@seed.alyxai.org:26656,cf242dd238a236074d8551d2fe04f6e8f409a6a3@seed2.alyxai.org:26656"

5. Core Public Endpoints

GET /api/health
GET /api/network/overview
GET /api/dex/pools
GET /api/dex/pools/{id}
GET /api/dex/params
GET /api/tokenfactory/metadata
GET /api/ai/models
GET /api/ai/pricing
POST /api/ai/execute

Additional public routes are available for pricing, wallet intelligence, address analytics, LP position surfaces, DEX analytics, and token metadata. The endpoints above are the primary public integration surface for external developers, wallets, explorers, and listing reviewers.

6. Gecko Adapter Endpoints

ALYX exposes a Gecko-style adapter layer for external market data integrations, pair indexing, asset discovery, and swap event ingestion.

GET /api/gecko/latest-block → latest indexed chain height and timestamp
GET /api/gecko/assets → adapter asset list with token image metadata
GET /api/gecko/pairs → paginated Gecko-style pair surface
GET /api/gecko/pairs/{id} → single pair by adapter id
GET /api/gecko/events → indexed multi-pool swap event feed
GET /api/gecko/events?limit={n}&from_block={height} → filtered swap events from a minimum block height

Current pair ids use the format alyx-{poolId}. Example: alyx-1 = ALYX / AI, alyx-2 = ALYX / GPU, alyx-3 = ALYX / DATA, alyx-4 = ALYX / MODEL, alyx-5 = ALYX / DeltaWolves.

The adapter currently exposes compatibility fields reserve_usd and volume_usd_24h, but these are presently ALYX-normalized compatibility values until a true ALYX/USD oracle or external reference index is added. Native protocol values are also exposed via reserve_alyx, volume_alyx_24h, and price_native. price_usd is intentionally returned as null until a real USD source exists.

GET https://alyxai.org/api/gecko/latest-block

{
  "chain_id": "alyxtest-4",
  "height": 996353,
  "timestamp": "2026-04-19T02:02:16.474066368Z"
}

GET https://alyxai.org/api/gecko/assets

[
  {
    "id": "ualyx",
    "symbol": "ALYX",
    "name": "ALYX",
    "image_url": "/assets/tokens/alyx.png"
  },
  {
    "id": "factory/alyx1spezpttcm7m7k64gtluenx9e5qlwudez0zvedk/AI",
    "symbol": "AI",
    "name": "AI",
    "image_url": "/assets/tokens/ai.png"
  }
]

GET https://alyxai.org/api/gecko/pairs

{
  "data": [
    {
      "id": "alyx-1",
      "dex_key": "alyx",
      "chain_id": "alyxtest-4",
      "pool_id": 1,
      "pair_name": "ALYX / AI",
      "base_token": {
        "id": "ualyx",
        "symbol": "ALYX",
        "name": "ALYX",
        "image_url": "/assets/tokens/alyx.png"
      },
      "quote_token": {
        "id": "factory/alyx1spezpttcm7m7k64gtluenx9e5qlwudez0zvedk/AI",
        "symbol": "AI",
        "name": "AI",
        "image_url": "/assets/tokens/ai.png"
      },
      "reserve_usd": 60101426.977242,
      "volume_usd_24h": 1393.887253,
      "reserve_alyx": 60101426.977242,
      "volume_alyx_24h": 1393.887253,
      "price_native": 0.301868440835,
      "price_usd": null,
      "created_at": null,
      "labels": ["verified-core", "canonical", "ai-economy"],
      "metadata": {
        "class": "Verified Core Pool",
        "isCanonical": true,
        "isVerifiedCore": true,
        "isCertified": false,
        "isCommunity": false,
        "pricingNote": "reserve_usd and volume_usd_24h are ALYX-normalized compatibility fields until a true USD oracle/index is added."
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 100,
    "total": 5,
    "hasNextPage": false
  }
}

GET https://alyxai.org/api/gecko/pairs/alyx-1

{
  "id": "alyx-1",
  "dex_key": "alyx",
  "chain_id": "alyxtest-4",
  "pool_id": 1,
  "pair_name": "ALYX / AI",
  "base_token": {
    "id": "ualyx",
    "symbol": "ALYX",
    "name": "ALYX",
    "image_url": "/assets/tokens/alyx.png"
  },
  "quote_token": {
    "id": "factory/alyx1spezpttcm7m7k64gtluenx9e5qlwudez0zvedk/AI",
    "symbol": "AI",
    "name": "AI",
    "image_url": "/assets/tokens/ai.png"
  },
  "reserve_usd": 60101426.977242,
  "volume_usd_24h": 1393.887253,
  "reserve_alyx": 60101426.977242,
  "volume_alyx_24h": 1393.887253,
  "price_native": 0.301868440835,
  "price_usd": null,
  "created_at": null
}

GET https://alyxai.org/api/gecko/events?limit=20&from_block=980000

{
  "data": [
    {
      "id": "3A9F1295FE393E53660A63A0C8B92D30DE33649EB816426758EBBF36EC49D9DF:0:0",
      "tx_hash": "3A9F1295FE393E53660A63A0C8B92D30DE33649EB816426758EBBF36EC49D9DF",
      "block_height": 996124,
      "timestamp": "2026-04-19T01:41:47.184253274Z",
      "pool_id": 4,
      "pair_id": "alyx-4",
      "event_type": "swap",
      "trader": "alyx1lanhuuymu6hw92ncwmkldkk7wld293z05rnkt8",
      "token_in": {
        "denom": "ualyx",
        "symbol": "ALYX",
        "amount_display": 25
      },
      "token_out": {
        "denom": "factory/alyx1spezpttcm7m7k64gtluenx9e5qlwudez0zvedk/MODEL",
        "symbol": "MODEL",
        "amount_display": 84.741823
      },
      "note": "token_out.amount_display currently reflects minAmountOutDisplay from the indexed swap feed until exact realized amount-out indexing is added."
    }
  ],
  "pagination": {
    "limit": 20,
    "totalReturned": 9,
    "filteredFromBlock": 980000
  }
}

7. Example: Health

GET https://alyxai.org/api/health

{
  "ok": true,
  "chainId": "alyxtest-4",
  "latestHeight": 994089,
  "latestBlockTime": "2026-04-18T22:39:15.438046917Z",
  "catchingUp": false,
  "timestamp": "2026-04-18T22:39:40.892Z"
}

8. Example: Network Overview

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

{
  "chainId": "alyxtest-4",
  "latestHeight": 994089,
  "latestBlockTime": "2026-04-18T22:39:15.438046917Z",
  "catchingUp": false,
  "activeValidators": 6,
  "totalSupply": "3026100033.649722",
  "bondedTokens": "59006.98",
  "genesisSupply": "3000000000",
  "trackedWalletSupply": "2856889821.232971",
  "untrackedSupply": "143110178.767029",
  "fundedWalletCount": 11,
  "canonicalLiquidity": {
    "canonicalPoolCount": 4,
    "alyxInPools": "135103263.27501",
    "aiInPools": "199098790.078333",
    "gpuInPools": "99997443.458863",
    "dataInPools": "99996197.524537",
    "modelInPools": "99998179.212604",
    "totalTrackedLiquidity": "634193873.549347"
  },
  "currentUpgrade": {
    "name": "tokenfactory-v1",
    "height": 383665,
    "status": "PROPOSAL_STATUS_PASSED",
    "proposalId": 3
  },
  "dex": {
    "live": true,
    "poolCount": 5,
    "swapFeeBps": 30,
    "poolCreationFee": "100000000"
  },
  "tokenfactory": {
    "live": true
  },
  "ai": {
    "live": true
  }
}

9. Example: DEX Pools

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

[
  {
    "poolId": 1,
    "tokenA": "ALYX",
    "tokenB": "AI",
    "denomA": "ualyx",
    "denomB": "factory/alyx1spezpttcm7m7k64gtluenx9e5qlwudez0zvedk/AI",
    "reserveADisplay": 60101212.299742,
    "reserveBDisplay": 199098790.078333,
    "pair": "ALYX / AI",
    "class": "Verified Core Pool",
    "isVerifiedCore": true,
    "isCanonical": true,
    "liquidityALYX": 60101212.299742
  },
  {
    "poolId": 5,
    "tokenA": "ALYX",
    "tokenB": "DeltaWolves",
    "denomA": "ualyx",
    "denomB": "factory/alyx1dtsxng9z7kkkmgc3fj3seg2vv4vllfp43nj6rg/DeltaWolves",
    "pair": "ALYX / DeltaWolves",
    "class": "Certified Pool",
    "isCanonical": false,
    "isCertified": true,
    "declaredLiquidityLock": "forever"
  }
]

10. Example: TokenFactory Metadata

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

[
  {
    "denom": "ualyx",
    "name": "ALYX",
    "symbol": "ALYX",
    "description": "Native monetary asset of ALYX and the base unit of value across the Autonomous Intelligence Ledger.",
    "image": "/assets/tokens/alyx.png",
    "website": "https://alyxai.org"
  },
  {
    "denom": "factory/alyx1spezpttcm7m7k64gtluenx9e5qlwudez0zvedk/AI",
    "name": "Artificial Intelligence",
    "symbol": "AI",
    "description": "Premium AI asset on ALYX, dynamically priced in ALYX through live on-chain liquidity..",
    "image": "/assets/tokens/ai.png"
  }
]

11. Example: AI Models

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

{
  "phase": "Live",
  "settlementAsset": "ALYX",
  "pricingUnit": "ALYX-denominated execution",
  "models": [
    {
      "id": "model-001",
      "slug": "alyx-core-llm",
      "name": "ALYX Core LLM",
      "category": "llm",
      "status": "live",
      "settlementAsset": "ALYX",
      "pricingMode": "usage",
      "registryAsset": "MODEL"
    },
    {
      "id": "model-002",
      "slug": "alyx-vision-alpha",
      "name": "ALYX Vision Alpha",
      "category": "vision",
      "status": "live",
      "settlementAsset": "ALYX",
      "pricingMode": "usage",
      "registryAsset": "MODEL"
    },
    {
      "id": "model-003",
      "slug": "alyx-data-indexer",
      "name": "ALYX Data Indexer",
      "category": "data",
      "status": "live",
      "settlementAsset": "ALYX",
      "pricingMode": "subscription",
      "registryAsset": "DATA"
    },
    {
      "id": "model-004",
      "slug": "alyx-agent-router",
      "name": "ALYX Agent Router",
      "category": "agent",
      "status": "live",
      "settlementAsset": "ALYX",
      "pricingMode": "fixed",
      "registryAsset": "AI"
    }
  ]
}

12. Example: AI Pricing

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

{
  "phase": "Live",
  "settlementAsset": "ALYX",
  "pricingUnit": "ALYX-denominated execution pricing",
  "items": [
    {
      "modelSlug": "alyx-core-llm",
      "modelName": "ALYX Core LLM",
      "status": "live",
      "pricingMode": "usage",
      "settlementAsset": "ALYX",
      "unitLabel": "per 1K tokens",
      "amount": "25000",
      "displayAmount": 0.025
    },
    {
      "modelSlug": "alyx-vision-alpha",
      "modelName": "ALYX Vision Alpha",
      "status": "live",
      "pricingMode": "usage",
      "settlementAsset": "ALYX",
      "unitLabel": "per image task",
      "amount": "50000",
      "displayAmount": 0.05
    },
    {
      "modelSlug": "alyx-data-indexer",
      "modelName": "ALYX Data Indexer",
      "status": "live",
      "pricingMode": "subscription",
      "settlementAsset": "ALYX",
      "unitLabel": "per month",
      "amount": "5000000",
      "displayAmount": 5
    },
    {
      "modelSlug": "alyx-agent-router",
      "modelName": "ALYX Agent Router",
      "status": "live",
      "pricingMode": "fixed",
      "settlementAsset": "ALYX",
      "unitLabel": "per routing job",
      "amount": "100000",
      "displayAmount": 0.1
    }
  ]
}

13. Example: AI Execution

POST https://alyxai.org/api/ai/execute
Content-Type: application/json

{
  "model": "alyx-core-llm",
  "input": "Give me a summary of the current ALYX network, DEX, and AI layer."
}

14. Price and Market Data

GET /api/price → full pricing surface
GET /api/price/alyx → ALYX base reference price
GET /api/price/{symbol} → symbol-specific pricing
GET /api/dex-analytics/status → analytics layer status
GET /api/dex-analytics/indexer → analytics indexer state
GET /api/dex-analytics/pools/{id}/summary → indexed swaps, reserves, volume, estimated fees
GET /api/dex-analytics/pools/{id}/history → pool price history
GET /api/dex-analytics/pools/{id}/volume → indexed volume by input denom
GET /api/dex-analytics/pools/{id}/swaps → recent swap feed
GET /api/dex-analytics/pools/{id}/fees-estimate → estimated fee output
GET /api/dex-analytics/pools/{id}/liquidity-history → liquidity snapshots
GET /api/dex-analytics/pools/{id}/trend-summary → price and liquidity trend summary
GET /api/dex-analytics/pools/{id}/lp-estimate/{address} → estimated LP earnings

15. Wallet and Address Intelligence

GET /api/address/{address}/dashboard → wallet intelligence overview
GET /api/address/{address}/overview → address summary
GET /api/address/{address}/balances → balances
GET /api/address/{address}/delegations → staking delegations
GET /api/address/{address}/txs → recent transactions
GET /api/dex/pools/{id}/position/{address} → pool-specific LP position
GET /api/dex/positions/{address} → wallet LP positions

16. DEX Model

AMM Model: Constant product AMM (x * y = k)

Swap Fee: 0.30%

LPs: 0.15%
Validators: 0.10%
Treasury: 0.05%

Pool Creation Fee: 100 ALYX (100000000 ualyx)

17. Architecture Notes

Native Cosmos SDK execution environment
CometBFT consensus and standard Cosmos account model
Non-EVM architecture; no router contracts are required for swaps
DEX execution is handled by on-chain module logic
TokenFactory denom standard: factory/<creator>/<denom>
Canonical ALYX economy pairs: ALYX/AI, ALYX/GPU, ALYX/DATA, ALYX/MODEL
Community and certified assets can coexist alongside the canonical ALYX economy

18. Monetary and Market Structure

Native Asset: ALYX
Monetary Base: ALYX
Canonical Premium Pair: ALYX / AI
Canonical AI Economy Pairs: ALYX / GPU, ALYX / DATA, ALYX / MODEL
Market Structure: Hub-and-spoke with ALYX as the base coordination asset
Price Discovery: DEX liquidity determines asset pricing in ALYX terms
AI Positioning: AI is a premium ecosystem asset priced in ALYX through live on-chain liquidity
Reference Positioning: GPU, DATA, and MODEL are canonical ALYX economy assets with ALYX liquidity pairs
Total Live Pools: includes canonical, certified, and community-eligible live pools
Canonical Pool Count: core ALYX economy pools only

19. Data Availability

Real-time pool and pricing data via public API
Historical price and liquidity tracking via DEX analytics routes
Indexed input-side volume and fee estimation via analytics routes
Wallet-level intelligence via public address dashboard surfaces
Token metadata via TokenFactory metadata routes
On-chain state accessible through RPC, LCD, and gRPC

20. Listing and Integration Notes

ALYX public docs are intended to support developer integrations, validator onboarding, and external listing review
Hostnames are preferred over raw IPs for public integrations; direct IPs are fallback only
ALYX pricing references should treat ALYX as the monetary base and on-chain liquidity as the source of truth for asset valuation
AI execution pricing is settled in ALYX through public AI pricing and execution routes

21. Notes

/api/price may mix protocol-reference pricing for ALYX with DEX-derived pricing for ALYX-paired assets
Historical analytics and fee estimates are analytics-layer outputs and should not be interpreted as exact accounting settlement records
Wallet dashboard values are ALYX-denominated and derived from balances, delegations, pricing, and indexed activity
Examples on this page are representative public responses and may change as the live network advances