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_URLconfigured (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_createwith broker name and chain IDs - Check deployment:
orderly_one_deploy_status(action: "status") - Configure branding:
orderly_one_social_cardwith social links - Generate a theme:
orderly_one_theme(action: "generate", prompt: "your style")
Customize Your DEX
- Theme: Use
orderly_one_themewith action "generate" for full themes or "fine_tune" for specific elements - Domain: Use
orderly_one_domainto set a custom domain (requires DNS CNAME setup) - Social: Use
orderly_one_social_cardto configure Twitter, Discord, Telegram links and OG image - Visibility: Use
orderly_one_visibilityto 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_statusrate 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 |