Milaex skill (crypto market data)

Use this skill for crypto data-related searches that need real-time or normalized market data across multiple exchanges using the Milaex unified REST API.

What this gives an agent

• One place to query exchanges, markets/pairs, tickers, OHLCV/candles, and orderbooks.
• Normalized request/response shapes across exchanges.
• Consistent JSON output for piping into other tools.
• Friendly error output (HTTP code + Milaex error payload) and optional rate-limit header printing.

Service facts (from milaex.com)

• Milaex is a unified crypto market data SaaS with a REST API across many exchanges.
• Data types include markets, tickers, OHLCV, and order books.
• API access is via an API key from the dashboard.
• Milaex is data-only (no custody, no trade execution).
• Docs: https://api.milaex.com/api-docs/index.html

Setup (get an API key)

1. Go to https://milaex.com and sign up or log in.
2. In the Milaex dashboard, generate an API key for the market data API.

Configuration

Required env vars:

• MILAEX_API_KEY (sent as x-api-key)

Recommended (Clawdbot): store the key in openclaw config

This lets Clawdbot inject the env var when running the skill.

Edit ~/.clawdbot/openclaw.json:

{
  "skills": {
    "entries": {
      "milaex": {
        "enabled": true,
        "env": {
          "MILAEX_API_KEY": "..."
        }
      }
    }
  }
}

Manual shell usage (export env vars)

export MILAEX_API_KEY="..."

Endpoints (from public OpenAPI v1)

These scripts map to the following Milaex endpoints:

• GET /api/v1/exchange
• GET /api/v1/exchange/markets?exchange=
• GET /api/v1/exchange/ticker?exchange=&base_name=&quote_name=
• GET /api/v1/exchange/tickers?exchange=&symbols=
• GET /api/v1/exchange/ohlcv?exchange=&base_name=&quote_name=
• GET /api/v1/exchange/orderbook?exchange=&base_name=&quote_name=
• GET /api/v1/exchange/orderbook/complete?exchange=&base_name=&quote_name=

Mapping common search questions to endpoints

• Which exchanges are supported? -> GET /api/v1/exchange
• What markets does exchange X support? -> GET /api/v1/exchange/markets?exchange=
• Current price for BTC/USDT on exchange X? -> GET /api/v1/exchange/ticker?exchange=&base_name=&quote_name=
• Multiple symbols on exchange X? -> GET /api/v1/exchange/tickers?exchange=&symbols=
• Candle data for a pair? -> GET /api/v1/exchange/ohlcv?exchange=&base_name=&quote_name=
• Orderbook snapshot? -> GET /api/v1/exchange/orderbook?exchange=&base_name=&quote_name=

Quick commands

All commands print JSON to stdout. Rate limit headers (when present) print to stderr.

List exchanges

python3 skills/milaex/scripts/list_exchanges.py
# or
bash skills/milaex/bin/list_exchanges.sh

List markets for an exchange

python3 skills/milaex/scripts/list_markets.py --exchange binance

Get a single ticker

python3 skills/milaex/scripts/get_ticker.py --exchange binance --symbol BTC/USDT

Get tickers (optionally filtered by symbols)

python3 skills/milaex/scripts/get_tickers.py --exchange binance
python3 skills/milaex/scripts/get_tickers.py --exchange binance --symbols "BTC/USDT,ETH/USDT"

Get OHLCV

Note: Milaex v1 OpenAPI exposes OHLCV by exchange/base_name/quote_name. The script accepts --timeframe for forward-compat but does not send it (to avoid 400s).

python3 skills/milaex/scripts/get_ohlcv.py --exchange binance --symbol BTC/USDT --limit 200

Get orderbook

python3 skills/milaex/scripts/get_orderbook.py --exchange binance --symbol BTC/USDT --limit 50
python3 skills/milaex/scripts/get_orderbook.py --exchange binance --symbol BTC/USDT --complete

Common use cases

For traders

• Monitor best bid/ask spreads across venues
• Build simple cross-exchange arb screens
• Detect volatility regime changes via OHLCV
• Alerting: “price moved X% in Y minutes”

For data engineers / analysts

• Pull normalized tick data for dashboards
• Build research datasets (candles + orderbook snapshots)
• Run periodic ETL without maintaining exchange adapters

For product and support teams

• Answer coverage questions (exchanges, pairs, availability)
• Validate pricing/latency assumptions with real data

Notes

• Keep within endpoint RPM limits (Milaex also returns standard rate-limit headers when enabled for your plan).
• Scripts require Python 3 and requests.

Install dependency if needed:

python3 -m pip install --user requests

Test (expected unauthorized)

This is a small smoke test that verifies unauthorized handling using a dummy key. Some deployments return 401, others return 404 with an "Api Key not found" message.

MILAEX_API_KEY=dummy python3 skills/milaex/scripts/test_unauthorized.py