# MEXC API
> Live spot market data from MEXC, a top centralised crypto exchange known for listing the widest range of altcoins and new tokens first. The ticker endpoint returns a symbol's 24h last price, bid/ask, high/low, volume and change. The tickers endpoint returns the top symbols by 24h quote volume. The movers endpoint returns the biggest 24h gainers or losers among liquid pairs — the altcoin-momentum view MEXC is watched for. Read live from MEXC, nothing stored. This is MEXC's own spot ticker and altcoin-momentum layer — a distinct centralised-exchange venue, separate from other exchange feeds and from DEX, lending and oracle APIs.

## 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/mexc-api/..."
```

## Pricing
- **Free** (Free) — 2,500 calls/Mo, 3 req/s
- **Starter** ($8/Mo) — 68,000 calls/Mo, 15 req/s
- **Pro** ($24/Mo) — 350,000 calls/Mo, 40 req/s
- **Scale** ($57/Mo) — 2,250,000 calls/Mo, 120 req/s

## Endpoints

### Ticker

#### `GET /v1/ticker` — A symbol's 24h ticker

**Parameters:**
- `symbol` (query, required, string) — Symbol (BTCUSDT or BTC) Example: `BTCUSDT`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/mexc-api/v1/ticker?symbol=BTCUSDT"
```

**Response:**
```json
{
    "data": {
        "ask": 61428.17,
        "bid": 61428.16,
        "last": 61425.49,
        "open": 61781.98,
        "time": "2026-06-10T22:56:39.240Z",
        "source": "MEXC",
        "symbol": "BTCUSDT",
        "low_24h": 60743.7,
        "high_24h": 62852.84,
        "change_24h": -356.49,
        "change_24h_pct": -0.57,
        "base_volume_24h": 7985.2002,
        "quote_volume_24h": 492528284.21
    },
    "meta": {
        "timestamp": "2026-06-10T22:56:40.603Z",
        "request_id": "2c0e8e88-6a4f-4c34-9808-7f808a688e7b"
    },
    "status": "ok",
    "message": "Ticker retrieved successfully",
    "success": true
}
```

### Tickers

#### `GET /v1/tickers` — Top symbols by 24h quote volume

**Parameters:**
- `quote` (query, optional, string) — Quote asset (USDT default) Example: `USDT`
- `limit` (query, optional, string) — Max results (1-200) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/mexc-api/v1/tickers?quote=USDT&limit=25"
```

**Response:**
```json
{
    "data": {
        "count": 25,
        "quote": "USDT",
        "source": "MEXC",
        "tickers": [
            {
                "ask": 61428.17,
                "bid": 61428.16,
                "last": 61425.49,
                "open": 61781.98,
                "time": "2026-06-10T22:56:39.124Z",
                "symbol": "BTCUSDT",
                "low_24h": 60743.7,
                "high_24h": 62852.84,
                "change_24h": -356.49,
                "change_24h_pct": -0.57,
                "base_volume_24h": 7985.2002,
                "quote_volume_24h": 492528284.21
            },
            {
                "ask": 1618.38,
                "bid": 1618.37,
                "last": 1618.37,
                "open": 1642.77,
                "time": "2026-06-10T22:56:39.123Z",
                "symbol": "ETHUSDT",
                "low_24h": 1603.17,
                "high_24h": 1668.23,
                "change_24h": -24.4,
                "change_24h_pct": -1.48,
                "base_volume_24h": 154759.3764,
                "quote_volume_24h": 252712573.7
            },
            {
                "ask": 62.86,
                "bid": 62.85,
                "last": 62.84,
                "open": 65.01,
                "time": "2026-06-10T22:56:39.121Z",
                "symbol": "SOLUSDT",
                "low_24h": 62.34,
                "high_24h": 65.76,
                "change_24h": -2.17,
                "change_24h_pct": -3.33,
                "base_v
…(truncated, see openapi.json for full schema)
```

### Movers

#### `GET /v1/movers` — Biggest 24h gainers or losers among liquid pairs

**Parameters:**
- `type` (query, optional, string) — gainers (default) or losers Example: `gainers`
- `min_volume` (query, optional, string) — Min 24h quote volume filter Example: `200000`
- `limit` (query, optional, string) — Max results (1-100) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/mexc-api/v1/movers?type=gainers&min_volume=200000&limit=20"
```

**Response:**
```json
{
    "data": {
        "type": "gainers",
        "count": 20,
        "quote": "USDT",
        "movers": [
            {
                "ask": 0.86989,
                "bid": 0.85982,
                "last": 0.85155,
                "open": 0.40569,
                "time": "2026-06-10T22:56:39.122Z",
                "symbol": "VELVETUSDT",
                "low_24h": 0.28766,
                "high_24h": 0.9757,
                "change_24h": 0.44586,
                "change_24h_pct": 109.9,
                "base_volume_24h": 2969791.66,
                "quote_volume_24h": 1576248.6
            },
            {
                "ask": 7.25278,
                "bid": 7.23047,
                "last": 7.29344,
                "open": 4.69602,
                "time": "2026-06-10T22:56:39.123Z",
                "symbol": "BEATUSDT",
                "low_24h": 4.4821,
                "high_24h": 8,
                "change_24h": 2.59742,
                "change_24h_pct": 55.31,
                "base_volume_24h": 2285670.82,
                "quote_volume_24h": 13422762.28
            },
            {
                "ask": 0.0002609,
                "bid": 0.00026,
                "last": 0.0002602,
                "open": 0.000173,
                "time": "2026-06-10T22:56:39.122Z",
                "symbol": "HMSTRUSDT",
                "low_24h": 0.0001716,
                "high_24h": 0.0002703,
                "change_24h": 8.72e-5,
                "change_24h_pct": 50.4,
         
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata

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

**Response:**
```json
{
    "data": {
        "source": "MEXC API v3 (api.mexc.com, live)",
        "service": "mexc-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/movers": "Biggest 24h gainers or losers among liquid pairs (type=gainers, min_volume=200000, limit=20).",
            "GET /v1/ticker": "A symbol's 24h ticker (symbol=BTCUSDT or BTC).",
            "GET /v1/tickers": "Top symbols by 24h quote volume (quote=USDT, limit=25)."
        },
        "description": "Live spot market data from MEXC, a top centralised crypto exchange known for listing the widest range of altcoins and new tokens first. The ticker endpoint returns a symbol's 24h last price, bid/ask, high/low, volume and change; the tickers endpoint returns the top symbols by 24h quote volume; the movers endpoint returns the biggest 24h gainers or losers among liquid pairs — the altcoin-momentum view MEXC is watched for. Live, no key, nothing stored. Distinct centralised-exchange venue, separate from other exchange feeds and from DEX, lending and oracle APIs — this is MEXC's own spot ticker and altcoin-momentum layer.",
        "symbol_count": 2415,
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-10T22:56:41.063Z",
        "request_id": "a22a657e-d855-4af0-9cfb-aa3de9276e61"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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