> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Crypto Exchange Listings API

> Tracks when trading pairs are listed, delisted, or otherwise changed on crypto exchanges.

`POST /v1/data/crypto/exchange-listings/run`

**Pricing:** $0.001 per exchange listing event ($1.00 per 1,000).

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**startDate** `date` *required*

Return listing events on or after this date (YYYY-MM-DD).

**endDate** `date`

Only return listing events on or before this date.

**exchange** `string`

Only events on this exchange. Leave empty for all exchanges.

Allowed values: `aster` (Aster), `binance` (Binance), `bitget` (Bitget), `bithumb` (Bithumb), `bybit` (Bybit), `coinbase` (Coinbase), `gate` (Gate), `hyperliquid` (Hyperliquid), `kraken` (Kraken), `okx` (OKX), `robinhood` (Robinhood), `upbit` (Upbit).

**symbol** `string`

Only events for this token, by ticker, e.g. PEPE or SOL. Leave empty for every token.

**eventType** `string` (default: listing)

Limit results to a specific kind of event.

Allowed values: `listing` (Listing), `delisting` (Delisting), `cancelled` (Cancelled), `advanced` (Advanced), `postponed` (Postponed).

**product** `string` (default: all)

Limit results to a market type such as spot or perpetual.

Allowed values: `spot` (Spot), `margin` (Margin), `perp` (Perpetual), `pre_market_perp` (Pre-market Perpetual), `all` (All).

**maxResults** `integer` (default: 100)

How many exchange listing events to return in total. Defaults to 100; use 0 for all.

Min `1`; max `100`.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/crypto/exchange-listings/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "startDate": "2026-12-17",
    "maxResults": 20
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/crypto/exchange-listings/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "startDate": "2026-12-17",
    "maxResults": 20
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/crypto/exchange-listings/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "startDate": "2026-12-17",
  "maxResults": 20
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one exchange listing event, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `listingId` | Listing Id | text |
| `exchange` | Exchange | text |
| `product` | Product | text |
| `pair` | Pair | text |
| `base` | Base | text |
| `quote` | Quote | text |
| `eventType` | Event Type | text |
| `effectiveAt` | Effective At | datetime |
| `publishedAt` | Published At | datetime |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "crypto/exchange-listings",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "pair": "DUOL/USDT",
      "effectiveAt": "2026-11-06T11:00:00Z",
      "publishedAt": "2026-11-06T09:31:53Z",
      "eventType": "LISTING",
      "quote": "USDT",
      "product": "PERP",
      "base": "DUOL",
      "exchange": "BYBIT",
      "listingId": "BYBIT:PERP:DUOL/USDT:LISTING:1793962800"
    }
  ]
}
```

## Related APIs

For the project behind a pair use [`crypto/projects`](https://docs.mindcase.co/apis/crypto/projects).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.