# Maya Protocol Cross-Chain DEX API
> Live data from MAYAChain, the THORChain-derived cross-chain decentralized exchange (native asset CACAO) that swaps native BTC, ETH, ARB, ADA and more without wrapping or KYC. Read every liquidity pool (asset, USD price, asset & CACAO depth, 24h volume, pool APY, savers APR, status); the full detail of a single pool by asset; the global DEX stats (CACAO price, swap count and volume, active users, liquidity added); the network and node stats (active node count, bonding & liquidity APY, total reserve); and the most recent on-chain actions (swaps, adds, withdraws). The Maya / cross-chain-DEX / liquidity layer for DeFi dashboards, swap routers and yield trackers.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/maya-api/..."
```

## Pricing
- **Free** (Free) — 3,400 calls/Mo, 2 req/s
- **Basic** ($17/Mo) — 74,000 calls/Mo, 5 req/s
- **Pro** ($46/Mo) — 275,000 calls/Mo, 15 req/s
- **Business** ($98/Mo) — 990,000 calls/Mo, 40 req/s

## Endpoints

### DEX

#### `GET /v1/actions` — Recent on-chain actions (swaps/adds/withdraws)

**Parameters:**
- `type` (query, optional, string) — Filter: swap, addLiquidity, withdraw Example: `swap`
- `limit` (query, optional, string) — Number of actions (1-50) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/maya-api/v1/actions?type=swap&limit=20"
```

**Response:**
```json
{
    "data": {
        "count": 20,
        "actions": [
            {
                "in": [
                    {
                        "coins": [
                            {
                                "asset": "BTC~BTC",
                                "amount": 0.00061496
                            }
                        ],
                        "address": "maya1tqjzul33srl289afkpgu7avlyyjhnt5u35n4zv"
                    }
                ],
                "out": [
                    {
                        "coins": [
                            {
                                "asset": "ETH~USDC-0XA0B86991C6218B36C1D19D4A2E9EB0CE3606EB48",
                                "amount": 40.359405
                            }
                        ],
                        "address": "maya1tqjzul33srl289afkpgu7avlyyjhnt5u35n4zv"
                    },
                    {
                        "coins": [
                            {
                                "asset": "ETH~USDC-0XA0B86991C6218B36C1D19D4A2E9EB0CE3606EB48",
                                "amount": 40.359405
                            }
                        ],
                        "address": "maya1tqjzul33srl289afkpgu7avlyyjhnt5u35n4zv"
                    }
                ],
                "type": "swap",
                "pools": [
                    "BTC.BTC",
                    "ETH.USDC-0XA0B86991C6218B36C1D19D4A2E9EB0CE3606EB48"
                ],
               
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/pool` — Full detail for one pool

**Parameters:**
- `asset` (query, required, string) — Pool asset (CHAIN.SYMBOL) Example: `BTC.BTC`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/maya-api/v1/pool?asset=BTC.BTC"
```

**Response:**
```json
{
    "data": {
        "pool": {
            "asset": "BTC.BTC",
            "status": "available",
            "pool_apy": 0.141137,
            "price_usd": 65634.81769587,
            "savers_apr": 0,
            "volume_24h": 1646179145.452221,
            "asset_depth": 29.97238417,
            "cacao_depth": 1735149941.365439,
            "native_decimal": 8,
            "price_in_cacao": 578916.22218769,
            "annual_pct_rate": 0.141137
        },
        "network": "MAYAChain"
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:03.371Z",
        "request_id": "1e0d633c-ba38-4013-9a04-f385fc3b154b"
    },
    "status": "ok",
    "message": "Pool retrieved successfully",
    "success": true
}
```

#### `GET /v1/pools` — All cross-chain liquidity pools

**Parameters:**
- `status` (query, optional, string) — Filter by pool status (e.g. available) Example: `available`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/maya-api/v1/pools?status=available"
```

**Response:**
```json
{
    "data": {
        "count": 19,
        "pools": [
            {
                "asset": "BTC.BTC",
                "status": "available",
                "pool_apy": 0.141137,
                "price_usd": 65634.81769587,
                "savers_apr": 0,
                "volume_24h": 1646179145.452221,
                "asset_depth": 29.97238417,
                "cacao_depth": 1735149941.365439,
                "native_decimal": 8,
                "price_in_cacao": 578916.22218769,
                "annual_pct_rate": 0.141137
            },
            {
                "asset": "ZEC.ZEC",
                "status": "available",
                "pool_apy": 0.076921,
                "price_usd": 471.39689749,
                "savers_apr": 0,
                "volume_24h": 7098323573.731759,
                "asset_depth": 3777.67053594,
                "cacao_depth": 1570696351.130685,
                "native_decimal": -1,
                "price_in_cacao": 4157.84366632,
                "annual_pct_rate": 0.076921
            },
            {
                "asset": "ETH.ETH",
                "status": "available",
                "pool_apy": 1.374038,
                "price_usd": 1720.11559459,
                "savers_apr": 0,
                "volume_24h": 7049893489.665102,
                "asset_depth": 393.99363288,
                "cacao_depth": 597761957.973,
                "native_decimal": 18,
                "price_in_cacao": 15171.86847928,
                "annual
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/stats` — Global DEX stats

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/maya-api/v1/stats"
```

**Response:**
```json
{
    "data": {
        "network": "MAYAChain",
        "swap_volume": 1276612504109.4592,
        "swap_count_24h": 42970,
        "swap_count_30d": 657729,
        "cacao_price_usd": 0.11337533,
        "swap_count_total": 11464260,
        "daily_active_users": 79,
        "add_liquidity_count": 16579,
        "add_liquidity_volume": 26357565340.99164,
        "monthly_active_users": 1293
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:03.838Z",
        "request_id": "fb538672-1f45-4aec-bb77-57270fe12d2a"
    },
    "status": "ok",
    "message": "Stats retrieved successfully",
    "success": true
}
```

### Network

#### `GET /v1/network` — Network & node stats

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/maya-api/v1/network"
```

**Response:**
```json
{
    "data": {
        "network": "MAYAChain",
        "bonding_apy": 0.459908,
        "liquidity_apy": 0.120673,
        "total_reserve": 18073320.53545727,
        "active_node_count": 38,
        "next_churn_height": 10016352832,
        "pool_share_factor": 0.55,
        "standby_node_count": 13,
        "total_pooled_cacao": 4955087042.356289
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:04.282Z",
        "request_id": "f0687004-dbff-427c-9e51-9af6c0adc502"
    },
    "status": "ok",
    "message": "Network retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — DEX metadata & endpoint guide

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/maya-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "dex": "Maya Protocol (cross-chain, THORChain-derived)",
        "token": "CACAO",
        "source": "Maya public Midgard API, keyless",
        "network": "MAYAChain",
        "examples": {
            "pool": "/v1/pool?asset=BTC.BTC",
            "pools": "/v1/pools?status=available",
            "actions": "/v1/actions?type=swap&limit=20"
        },
        "endpoints": {
            "/v1/pool": "full detail for one pool (asset=BTC.BTC)",
            "/v1/pools": "all liquidity pools (asset, USD price, depths, 24h volume, APY; status filter)",
            "/v1/stats": "global DEX stats (CACAO price, swap count/volume, active users)",
            "/v1/actions": "recent on-chain actions — swaps/adds/withdraws (type, limit)",
            "/v1/network": "network & node stats (active nodes, bonding/liquidity APY, reserve)"
        },
        "cache_ttl_ms": 30000
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:04.377Z",
        "request_id": "b3ee351c-22fc-4b3e-9078-03c4eff9eda3"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/maya-api
OpenAPI spec: https://www.oanor.com/api/maya-api/openapi.json
