ADEN Exchange API Documentation

CoinGecko Integration API v1.0

Overview

ADEN is a decentralized perpetual exchange aggregating liquidity from multiple sources. This API provides unified access to all trading pairs with aggregated volume and liquidity metrics.

Supported Protocols

- Orderly Network (USDC-settled perpetuals)

- AsterDEX (USDT-settled perpetuals)

- Gate DEX (Coming soon)

Base Information

Base URL
https://perp-api.aden.io
Exchange Type
Perpetual DEX
Authentication
None (Public)
Rate Limit
1000 req/min

API Endpoints

GET /contracts [Try it]

Returns comprehensive data for all available perpetual contracts including pricing, volume, and open interest.

Response Fields

Field Type Description Status
ticker_id string Unique identifier (e.g., "BTC-PERPUSDC") Required
base_currency string Base asset symbol (e.g., "BTC") Required
target_currency string Quote currency (USDC/USDT) Required
last_price decimal Last traded price Required
base_volume decimal 24h volume in base currency Required
target_volume decimal 24h volume in quote currency Required
product_type string Contract type (always "Perpetual") Required
open_interest decimal Open interest in contracts Required
open_interest_usd decimal Open interest in USD Required
index_price decimal Underlying index price Required
funding_rate decimal Current funding rate Required

Example Response

[
  {
    "ticker_id": "BTC-PERPUSDC",
    "base_currency": "BTC",
    "target_currency": "USDC",
    "last_price": 110052.13,
    "base_volume": 2926.12,
    "target_volume": 321980000,
    "product_type": "Perpetual",
    "open_interest": 1523.45,
    "open_interest_usd": 167580000,
    "index_price": 110048.22,
    "funding_rate": 0.0001,
    "next_funding_rate_timestamp": 1738288800000
  }
]
GET /contract_specs [Try it]

Returns contract specifications including pricing type and settlement currency.

Response Fields

Field Type Description Status
ticker_id string Contract identifier Required
contract_type string Contract type (Vanilla/Inverse/Quanto) Required
contract_price_currency string Settlement currency Required
GET /orderbook [Try it]

Returns order book depth for a specific trading pair.

Query Parameters

Parameter Type Description Status
ticker_id string Trading pair identifier Required
depth integer Order book depth (default: 100) Optional

Example Request

GET https://perp-api.aden.io/orderbook?ticker_id=BTC-PERPUSDC&depth=50

Response Format

All API responses are returned in JSON format with appropriate HTTP status codes.

Success Response

HTTP 200 OK with JSON data

Error Response

HTTP 4xx/5xx with error message in JSON format

Rate Limits

API rate limits are enforced to ensure fair usage and system stability.

Endpoint Rate Limit Window
/contracts 1000 requests 1 minute
/contract_specs 1000 requests 1 minute
/orderbook 1000 requests 1 minute