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
API Endpoints
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
}
]
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 |
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 |