API Introduction

The Dexodus Trading API is a RESTful API that enables developers to programmatically interact with the Dexodus decentralized perpetual exchange. Build trading bots, integrate Dexodus into your application, or create custom trading interfaces with full access to market data, position management, and order execution.

  • Base URL: https://api.dexodus.finance

  • API Version: 1.0.0

Key Features

  • Account Management: Access smart account balances and create session keys for gasless trading using our DApp.

  • Market Data: Real-time perpetual market prices, funding rates, and market information.

  • Position Management: Open, close, and monitor leveraged positions up to 160x.

  • Order Management: Create and manage limit orders, take-profit, and stop-loss orders.

  • Gasless Trading: Execute trades without worrying about gas fees.

  • Session-Based Authentication: Secure, limited API access using a private API Key.


Core API Concepts

Session Keys

When you create an API key, a session key with session details is generated on-chain with specific permissions. This allows gasless trading while maintaining security.

Gasless Trading

All trades executed through the API are gasless—you don't need to hold ETH. Transaction fees are sponsored by Dexodus 😉.

Order Types

Market Orders

Execute immediately at the current market price. Ideal for entering or exiting positions quickly.

Limit Orders

Execute only when the market reaches your specified price. Perfect for entry strategies and automation.

IMPORTANT: Limit orders return both a positionId (future position) and an orderId (to manage/cancel the order).

You can also use limit orders to create Take-Profit (TP) and Stop-Loss (SL) orders to manage risk. There are two primary methods: creating them when you open a position, or adding them to an existing position later.


Vocabulary

  • Collateral: The amount of USDC you deposit for the position.

  • Leverage: Multiplier applied to your collateral (1x to 100x).

  • Position Size: collateral × leverage

    • Example: $100 collateral with 10x leverage = $1,000 position size.

  • Slippage: The maximum percentage of price change you are willing to tolerate for a trade to be executed.

    • Example: If you want to buy an asset at an expected price of $100 and set a 0.5% slippage tolerance, your order will only go through if the final execution price is $100.50 or less.

Last updated