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