Orderly One — DEX Builder

Build, customize, and manage your own decentralized exchange (DEX) on Orderly Network using the Orderly One DEX-as-a-Service platform. Your DEX inherits Orderly's shared liquidity, central limit orderbook, and cross-chain settlement infrastructure — you focus on branding, community, and growth.

Prerequisites

• Wallet: Agent must be running on Fly.io with WALLET_SERVICE_URL configured (EIP-191 signing via Privy)

• No API keys needed: Authentication uses the agent's EVM wallet address + JWT tokens

How It Works

Orderly One lets you launch a white-label DEX with:

• Shared orderbook liquidity from the entire Orderly Network

• Multi-chain deployment (Arbitrum, Optimism, Base, Polygon, etc.)

• Custom branding — name, logo, colors, domain

• AI-powered theming — generate themes from text prompts

• Graduation path — move from sandbox to production with your own broker ID

Authentication uses JWT tokens obtained via EIP-191 personal_sign (different from the Ed25519 auth used for Orderly trading).

Tool Reference

Tool Auth Purpose

orderly_one_networks

None List supported chains for DEX deployment

orderly_one_leaderboard

None DEX rankings, broker stats by volume/users

orderly_one_stats

None Platform-wide aggregate statistics

orderly_one_dex_get

JWT Get your DEX config or a specific DEX by ID

orderly_one_dex_create

JWT Create a new DEX (name, chains, branding)

orderly_one_dex_update

JWT Update DEX configuration

orderly_one_dex_delete

JWT Delete a DEX (destructive)

orderly_one_social_card

JWT Update social links and OG metadata

orderly_one_domain

JWT Set or remove a custom domain

orderly_one_visibility

JWT Toggle leaderboard visibility

orderly_one_deploy_status

JWT Check deployment status, trigger upgrades

orderly_one_theme

JWT AI theme generation and fine-tuning

orderly_one_graduation

JWT Graduate DEX to production

Workflows

Build a DEX

• Check available networks: orderly_one_networks

• Create your DEX: orderly_one_dex_create with broker name and chain IDs

• Check deployment: orderly_one_deploy_status (action: "status")

• Configure branding: orderly_one_social_card with social links

• Generate a theme: orderly_one_theme (action: "generate", prompt: "your style")

Customize Your DEX

• Theme: Use orderly_one_theme with action "generate" for full themes or "fine_tune" for specific elements

• Domain: Use orderly_one_domain to set a custom domain (requires DNS CNAME setup)

• Social: Use orderly_one_social_card to configure Twitter, Discord, Telegram links and OG image

• Visibility: Use orderly_one_visibility to show/hide on the public leaderboard

Graduate to Production

• Check eligibility: orderly_one_graduation (action: "status")

• Review fee options: orderly_one_graduation (action: "fees")

• Make payment and verify: orderly_one_graduation (action: "verify", tx_hash, chain_id)

• Finalize with admin wallet: orderly_one_graduation (action: "finalize", admin_wallet)

Monitor & Upgrade

• Check deployment status: orderly_one_deploy_status (action: "status")

• Check for upgrades: orderly_one_deploy_status (action: "upgrade_check")

• Trigger upgrade: orderly_one_deploy_status (action: "upgrade")

• View workflow run details: orderly_one_deploy_status (action: "workflow", run_id)

Supported Chains

Use orderly_one_networks for the current list. Commonly supported:

Chain Chain ID

Arbitrum 42161

Optimism 10

Base 8453

Polygon 137

Mantle 5000

Sei 1329

Error Handling

• 401 Unauthorized: JWT expired — automatically refreshed on retry

• 403 Forbidden: Wallet not authorized for this DEX

• 404 Not Found: DEX ID doesn't exist

• 429 Rate Limited: Too many requests — check orderly_one_deploy_status rate limit status

Environment Variables

Variable Default Description

WALLET_SERVICE_URL

Required Privy wallet service URL

ORDERLY_ONE_API_URL

https://api.dex.orderly.network

API base URL