Welcome to the comprehensive Wallet-as-a-Service (WaaS) Web3 API documentation, your go-to resource for integrating decentralized exchange (DEX) functionalities, managing digital wallets, and building powerful DeFi applications. Whether you're a developer working on a new dApp or scaling an existing blockchain solution, this guide provides structured access to essential tools like the Limit Order API, DEX Aggregation, Cross-Chain Swaps, and more.
Designed with clarity and usability in mind, this documentation supports developers at every stage—from onboarding to advanced implementation.
👉 Discover how to seamlessly integrate DEX and wallet APIs into your project today.
Understanding OKX OS and Wallet-as-a-Service
OKX OS is a developer-first ecosystem that powers Web3 innovation through modular, scalable, and secure APIs. At its core is Wallet-as-a-Service (WaaS), a suite of tools enabling developers to embed non-custodial wallet capabilities, execute trades across DEXs, and interact with multiple blockchains—all via simple API calls.
With WaaS, you can:
- Create and manage user-controlled wallets
- Query real-time on-chain data
- Broadcast transactions securely
- Enable seamless trading experiences
Before diving into specific APIs, ensure you meet the integration prerequisites and review the list of supported networks to confirm compatibility with your target ecosystems.
Core API Categories
The WaaS platform is organized into several key modules, each tailored to a distinct aspect of Web3 development.
Wallet API
The Wallet API allows full control over wallet lifecycle management and transaction handling.
Key Features:
- Wallet Creation & Management: Generate secure, non-custodial wallets programmatically.
- On-Chain Data Queries: Retrieve balances, transaction histories, and network statuses.
- Transaction Broadcasting: Sign and send transactions directly through the API.
- Client SDKs: Utilize signing libraries for secure key management across environments.
This module is ideal for apps requiring embedded wallet functionality without managing private keys on your servers.
👉 Start building with secure, scalable wallet integrations now.
DEX API
The DEX API unlocks decentralized trading capabilities within your application. It includes aggregation, cross-chain swaps, and advanced order types such as limit orders.
Key Components:
- Swap Aggregation: Access optimal prices across top DEXs using smart routing.
- Cross-Chain API: Bridge assets between chains with minimal slippage.
- Limit Order API: Place, manage, and track limit orders on supported networks.
- DEX Widget: Embed a ready-to-use trading interface with minimal code.
These tools empower developers to offer centralized-exchange-like experiences in a fully decentralized manner.
Limit Order API: Automate Your Trading Strategy
The Limit Order API enables users to set custom buy/sell conditions based on price thresholds—bringing precision and automation to DeFi trading.
Core Endpoints:
- Get Supported Chains: List all networks where limit orders are available.
- Get Token List: Retrieve supported tokens for trading pairs.
- Approve Transaction: Grant token spending permissions via allowance checks.
- Create Limit Order: Submit a new order with specified price and quantity.
- Query Limit Orders: Fetch active, filled, or canceled orders by user or ID.
- Cancel Limit Order: Generate calldata to revoke an existing order.
All operations are non-custodial—users retain control of their assets at all times.
Use Cases:
- Automated portfolio rebalancing
- Price-triggered entry/exit strategies
- Market-making bots
- Stop-loss-like behavior in DeFi
This level of control bridges the gap between traditional finance logic and decentralized infrastructure.
Market API
Monetize digital assets with the Market API, supporting various NFT and token standards across emerging ecosystems.
Supported Markets:
- NFT Marketplace API: List, trade, and query NFTs across major chains.
- BTC Ordinals & Runes API: Interact with Bitcoin-native digital collectibles.
- Fractal Ordinals API: Access next-gen Bitcoin layer functionalities.
Developers can build marketplaces, analytics dashboards, or minting platforms with unified endpoints.
DeFi API
The DeFi API simplifies interaction with lending protocols, yield farms, staking pools, and liquidity protocols.
Highlights:
- Unified access to multiple DeFi protocols
- Real-time APR, TVL, and position tracking
- Deposit, withdraw, and claim actions via API
Perfect for yield aggregators, portfolio trackers, or automated investment bots.
Technical Resources & Best Practices
To ensure smooth integration and long-term maintainability, explore these developer resources:
Integration Standards
Review the official Interface Specifications for request/response formats, authentication methods (e.g., API keys, JWT), rate limits, and error handling patterns.
Mobile App Integration
Use the guide on creating Universal Links to connect mobile dApps with wallet clients seamlessly—no QR codes required.
Stay Updated
Check the Changelog regularly for new features, deprecations, and performance improvements.
Legal & Compliance
All integrations must comply with the OKX Web3 Build User Agreement, ensuring responsible usage of the platform.
Frequently Asked Questions (FAQ)
Q: What is Wallet-as-a-Service (WaaS)?
A: WaaS is a cloud-based infrastructure that allows developers to integrate non-custodial wallet features—like creation, signing, and transaction broadcasting—into their apps without managing private keys directly.
Q: Which blockchains are supported?
A: The platform supports major EVM-compatible chains (Ethereum, BSC, Polygon) as well as Bitcoin-based layers (Ordinals, Runes) and other leading networks. Refer to the "Supported Networks" section for full details.
Q: Is the Limit Order API custodial?
A: No. All funds remain under user control. Orders are executed via smart contracts, and users must approve token allowances before trading.
Q: Can I embed a trading interface without coding from scratch?
A: Yes. The DEX Widget provides a plug-and-play UI component that supports swaps, limit orders, and cross-chain trades with minimal setup.
Q: How do I handle failed transactions or errors?
A: Each API module includes an Error Code Reference detailing common issues—from invalid signatures to insufficient gas—and recommended fixes.
Q: Are there rate limits on API usage?
A: Yes. Rate limits vary by endpoint and authentication level. Authenticated requests typically receive higher quotas. Monitor your usage via the developer dashboard.
Final Thoughts
Integrating Web3 functionality has never been more accessible. With OKX’s Wallet-as-a-Service platform, developers can leverage robust APIs for wallets, DEX trading, NFT markets, and DeFi—all designed for security, scalability, and ease of use.
Whether you're launching a new dApp or enhancing an existing one, the tools are here to accelerate your development cycle and deliver superior user experiences.
👉 Unlock powerful Web3 integrations with a single click—start exploring now.