​
Welcome to UniDex API

The UniDex Trading API provides programmatic access to UniDex’s trading functionality, allowing you to integrate our advanced trading features into your applications.

​
Base URL

All API requests should be made to: 
https://unidexv4-api-production.up.railway.app

​
Authentication

Currently, our public endpoints don’t require authentication. However, you’ll need to provide Ethereum addresses for user-specific operations.

​
Request Format

  • For GET requests, parameters should be sent as query parameters
  • For POST requests, parameters should be sent in the request body as JSON
  • All addresses should be in standard Ethereum format (0x…)

​
Common Parameters

Many endpoints accept these common parameters:
  • address: Ethereum address of the user
  • assetId: Trading pair identifier (e.g., 1 for BTC/USD)
Looking to build custom integrations? We offer grants for developers! Contact us through our Discord.

​
Rate Limits

Please be mindful of our rate limits:
  • Maximum of 10 requests per second per IP
  • Maximum of 100 requests per minute per IP

​
Error Handling

The API uses conventional HTTP response codes:
  • 2xx for successful requests
  • 4xx for failed requests that can be resolved by the user
  • 5xx for internal server errors

​
Open Source

Our API implementations are open source and can be found on our GitHub. You’re welcome to:
  • Run your own instance
  • Contribute improvements
  • Report issues
  • Submit feature requests

Getting Started

Start with basic API operations

Trading Operations

Learn about position management

Wallet Operations

Handle deposits and withdrawals