Home / Learn / Migration Guide
Migration Guide

Migrate from dYdX to perps.studio

A practical migration guide for teams moving from dYdX v4 to perps.studio's whitelabel perpetual futures infrastructure on Hyperliquid and Aster DEX.

If you've built a perpetual futures front-end or branded trading experience on dYdX v4, you already understand the value of offering decentralized derivatives to your community. However, dYdX's Cosmos-based architecture introduces operational complexity, validator requirements, and limited customization options that can slow your team down. perps.studio offers a fully managed whitelabel infrastructure layer that routes through Hyperliquid (HIP-3) and Aster DEX, giving you deep liquidity, lower latency, and complete branding control without running your own chain infrastructure.

This guide walks you through every step of migrating from dYdX v4 to perps.studio, including what changes, what stays the same, timeline expectations, and common pitfalls to avoid.

Why Migrate from dYdX to perps.studio

dYdX v4 launched its own Cosmos-based appchain, which means teams building on top of it face several operational hurdles that perps.studio eliminates entirely:

  • No validator infrastructure required: dYdX v4 requires interacting with a Cosmos-based chain, complete with validators, governance proposals, and chain upgrades. perps.studio abstracts all of this away, routing trades through Hyperliquid and Aster DEX without any chain-level overhead.
  • Superior liquidity depth: Hyperliquid consistently ranks among the highest-volume on-chain perpetual futures venues, often exceeding $5B+ in daily volume. Your users get tighter spreads and lower slippage from day one.
  • Full whitelabel branding: While dYdX offers limited front-end customization, perps.studio gives you complete control over your trading terminal's look and feel, including custom domains, logos, color schemes, and UI layouts.
  • Built-in revenue infrastructure: perps.studio includes native revenue sharing, referral systems, and fee management dashboards. On dYdX, these require custom smart contract development or off-chain systems.
  • One-click trading and sub-accounts: perps.studio supports one-click trading, sub-account management, and vault systems out of the box, features that require significant development effort to implement on dYdX v4.

Architecture Comparison: dYdX v4 vs perps.studio

Understanding the architectural differences between dYdX v4 and perps.studio helps you plan your migration effectively.

FeaturedYdX v4perps.studio
Underlying chaindYdX Chain (Cosmos SDK)Hyperliquid L1 / Aster DEX
Order bookOff-chain matching, on-chain settlementFully on-chain order book (Hyperliquid)
Margin modesCross marginCross, isolated, and portfolio margin
Whitelabel supportLimited front-end forkingFull whitelabel with managed infrastructure
Revenue sharingManual / custom contractsNative revenue sharing and referral system
Latency~1-2 seconds (Cosmos consensus)Sub-second (Hyperliquid optimistic execution)
Supported markets~80+ pairs150+ pairs via Hyperliquid and Aster DEX
Vault managementNot nativeBuilt-in vault management system

The most significant architectural shift is moving from a Cosmos-based settlement layer to Hyperliquid's purpose-built L1 for derivatives. This means faster execution, deeper liquidity, and no need to manage chain-level infrastructure.

What Changes vs What Stays the Same

Migration doesn't mean rebuilding from scratch. Here's a clear breakdown of what changes and what your team can carry forward.

What stays the same

  • Your brand identity, domain, and user-facing experience
  • Core trading functionality: limit orders, market orders, stop-loss, take-profit
  • Your user community and trader base
  • Basic perpetual futures mechanics (funding rates, liquidation engines, leverage)
  • Your marketing site and acquisition funnels

What changes

  • Wallet connections: Users will connect EVM-compatible wallets instead of Cosmos wallets. Most traders already have MetaMask or similar wallets, so friction is minimal.
  • Margin system: You gain access to isolated and portfolio margin modes in addition to cross margin.
  • Settlement asset: Trades settle in USDC on Hyperliquid rather than USDC on the dYdX Chain.
  • API endpoints: If you've built custom integrations, API endpoints will change to perps.studio's managed API layer.
  • Fee structure: Fees route through perps.studio's revenue sharing model, which typically offers better economics for operators.

Step-by-Step Migration Process

Follow this checklist to migrate from dYdX v4 to perps.studio with minimal disruption to your users.

Phase 1: Setup and Configuration (Days 1-3)

  • Sign up for a perps.studio operator account and complete onboarding
  • Configure your custom domain and SSL certificates
  • Upload your brand assets: logo, favicon, color palette, and typography preferences
  • Set up your revenue sharing parameters and fee tiers
  • Configure your referral system structure

Phase 2: Terminal Customization (Days 3-7)

  • Customize the trading terminal layout using perps.studio's configuration options
  • Select which trading pairs to feature on your exchange
  • Configure default margin modes and leverage limits for your users
  • Set up sub-account structures if applicable
  • Test one-click trading and order execution flows

Phase 3: Integration and Testing (Days 7-10)

  • Update any custom API integrations to use perps.studio's API endpoints
  • Migrate webhook configurations for notifications and alerts
  • Run end-to-end testing across all order types and margin modes
  • Verify revenue sharing calculations with test trades
  • Test wallet connection flows across MetaMask, WalletConnect, and other providers

Phase 4: User Migration and Launch (Days 10-14)

  • Announce the migration to your user base with clear instructions
  • Provide a guided wallet transition flow for users moving from Cosmos wallets
  • Deploy your new perps.studio-powered exchange to production
  • Monitor order execution, latency, and user onboarding metrics
  • Sunset your dYdX v4 integration once migration is confirmed complete

Timeline and Resource Expectations

Most teams complete a dYdX-to-perps.studio migration within 10-14 business days. Here's what to expect at each stage:

PhaseDurationTeam Resources Needed
Setup and configuration2-3 days1 project lead, 1 developer
Terminal customization3-5 days1 developer, 1 designer
Integration and testing3-5 days1-2 developers
User migration and launch2-4 days1 developer, 1 community manager

Teams with minimal custom API integrations can often complete the migration in under a week. The most time-intensive step is typically user communication and wallet transition support, not the technical migration itself.

Compared to the initial dYdX v4 setup (which often takes weeks to months due to chain infrastructure requirements), migrating to perps.studio is significantly faster because the infrastructure is fully managed.

Common Pitfalls and How to Avoid Them

Teams migrating from dYdX v4 to perps.studio occasionally encounter these issues. Here's how to handle them proactively:

  • Forgetting to update API integrations: If you've built bots, dashboards, or analytics tools that pull data from dYdX's API, these need to be updated to perps.studio's API endpoints. Create an inventory of all integrations before starting migration.
  • Cosmos wallet lock-in assumptions: Some teams worry that users with Cosmos-only wallets will be lost. In practice, most active crypto traders already have EVM wallets. Provide clear bridging instructions for users who need to move funds from Cosmos to an EVM chain.
  • Underestimating user communication: The technical migration is straightforward, but user confusion can create support volume. Prepare FAQ documents, migration guides, and consider a phased rollout where both platforms run in parallel briefly.
  • Not testing margin mode differences: dYdX v4 primarily offers cross margin. perps.studio supports cross, isolated, and portfolio margin. Test all modes to ensure your risk documentation and user guides are accurate.
  • Skipping revenue sharing configuration: perps.studio's revenue sharing is powerful but needs proper configuration. Set up your fee tiers, referral percentages, and payout schedules before launch rather than trying to adjust them after go-live.

Post-Migration: Leveraging perps.studio Features

Once your migration is complete, take advantage of perps.studio features that weren't available on dYdX v4:

  • Vault management: Create and manage trading vaults that allow your community to pool capital and follow specific strategies. This is a powerful engagement tool that dYdX v4 doesn't offer natively.
  • Advanced referral system: Deploy multi-tier referral programs with custom commission structures. Track referral performance through your operator dashboard.
  • Portfolio margin: Offer sophisticated traders portfolio margin mode, which calculates margin requirements across all positions rather than per-position. This is a major draw for professional traders.
  • Sub-accounts: Enable users to create multiple sub-accounts for different strategies, keeping risk isolated while using a single login.
  • Real-time order book visualization: perps.studio's trading terminal includes a high-performance order book display powered by Hyperliquid's real-time data, giving your users a CEX-like experience.

The reference implementation at Everex (everex.pro) demonstrates the full feature set available to perps.studio operators and serves as an example of what your branded exchange can look like post-migration.

Frequently Asked Questions

How long does it take to migrate from dYdX v4 to perps.studio?

Most teams complete the migration in 10-14 business days. Teams with minimal custom API integrations can often finish in under a week. The technical setup is fast because perps.studio provides fully managed infrastructure; most time is spent on terminal customization and user communication.

Do my users need to create new wallets?

Users will connect EVM-compatible wallets (such as MetaMask or WalletConnect-supported wallets) instead of Cosmos wallets. Most active crypto traders already have EVM wallets. For users who only have Cosmos wallets, provide bridging instructions to move their USDC to an EVM chain.

Will my users experience downtime during the migration?

No. The recommended approach is to launch your perps.studio-powered exchange in parallel with your existing dYdX integration, then transition users over a defined period. This ensures zero downtime and gives users time to complete the wallet transition.

How does liquidity on perps.studio compare to dYdX v4?

perps.studio routes through Hyperliquid and Aster DEX, which collectively offer some of the deepest on-chain perpetual futures liquidity available. Hyperliquid regularly processes over $5B in daily volume, often exceeding dYdX v4's volume, resulting in tighter spreads and lower slippage for your users.

Can I keep my existing fee structure?

perps.studio supports flexible fee configuration, so you can replicate or improve upon your existing fee structure. The platform's native revenue sharing model typically provides better economics for operators compared to running infrastructure on dYdX v4.

Do I need to run any blockchain infrastructure after migrating?

No. Unlike dYdX v4, which requires interaction with Cosmos-based infrastructure, perps.studio is fully managed. You don't need to run validators, manage chain upgrades, or handle on-chain governance. All infrastructure is handled by the perps.studio platform.

Ready to launch your exchange?

perps.studio gives you the infrastructure to deploy a fully branded perpetual futures exchange in minutes.