Orderly One Dex

Orderly Network: Orderly One DEX

Orderly One is a white-label DEX platform. Users configure a DEX (name, branding, chains), the API forks a GitHub template repo, and GitHub Actions deploys to GitHub Pages. Graduated DEXs earn fee splits.

When to Use

• Creating a custom perpetuals DEX
• Managing DEX deployment, domains, or themes
• Handling graduation for fee sharing

API Base URLs

API Categories

Use get_orderly_one_api_info MCP tool for full endpoint details.

Create/Update DEX

Both POST /api/dex (create) and PUT /api/dex/{id} (update) use multipart/form-data.

Required Fields

Optional Fields

Chains:

Branding (files):

Theming:

Social:

Auth/Wallet:

Network:

Trading:

Menus:

SEO:

Other:

Response

Create (201): { id, brokerId, brokerName, repoUrl, userId, createdAt }

Update (200): Full DEX object with all fields

Key Workflows

Authentication

1. POST /api/auth/nonce with { address } → get message to sign
2. Sign: "Sign this message to authenticate with Orderly One: {nonce}"
3. POST /api/auth/verify with { address, signature } → get JWT
4. Use Authorization: Bearer {token} for all requests

Create DEX Flow

1. Build multipart/form-data with fields above
2. POST /api/dex → returns { id, brokerId, repoUrl }
3. Poll GET /api/dex/{id}/workflow-status until conclusion: "success"

Graduation (Fee Sharing)

1. GET /api/graduation/fee-options → USDC/ORDER amounts + receiverAddress
2. Transfer tokens on Ethereum, Arbitrum, or Base to receiverAddress
3. POST /api/graduation/verify-tx with { txHash, chain, chainId, chainType: "EVM", brokerId, makerFee, takerFee, rwaMakerFee, rwaTakerFee, paymentType } → creates broker ID

After broker ID created, finalize admin wallet:

EVM Wallet: 4. Register with Orderly Network API:

• GET https://api.orderly.org/v1/registration_nonce
• Sign EIP-712 typed data: { brokerId, chainId, timestamp, registrationNonce }
• POST https://api.orderly.org/v1/register_account with { message, signature, userAddress, chainType: "EVM" }

5. POST /api/graduation/finalize-admin-wallet (empty body)

Solana Wallet: 4. Register with Orderly Network API:

• GET https://api.orderly.org/v1/registration_nonce
• Sign message with Solana wallet: { brokerId, chainId: 900900900, timestamp, registrationNonce }
• POST https://api.orderly.org/v1/register_account with { message, signature, userAddress, chainType: "SOL" }

5. POST /api/graduation/finalize-admin-wallet (empty body)

EVM Multisig/Gnosis Safe: 4. In Safe Wallet → Transaction Builder → create batch:

• To: Orderly Vault contract (chain-specific)
• Method: delegateSigner
• Data: [keccak256(brokerId), userAddress]

5. Execute on Safe with required signer approvals
6. POST /api/graduation/finalize-admin-wallet with { multisigAddress, multisigChainId }

Orderly MCP

This skill references the Orderly MCP server. If not installed, see orderly-onboarding skill for setup.

Tool: get_orderly_one_api_info

• { endpoint: "/api/dex" } - Specific endpoint details
• { category: "graduation" } - All endpoints in a category
• {} - Full API overview

Common Issues

Related Skills

• orderly-onboarding - Account setup
• orderly-trading-orders - Trading functionality