# Binance Announcements API
> Live Binance announcements — new coin listings, delistings, news and activities — with no key. Binance's official announcements move markets: a new-listing post routinely front-runs a price spike, a delisting a drop. This reads Binance's own public CMS announcement feed and returns it as clean JSON. List the latest new cryptocurrency listings on Binance; read the announcements in any category (new listings, delistings, latest news, activities, fiat listings, API updates); and read the merged latest announcements across the key categories, newest first — each with its title, category, publish time and the direct announcement URL. The listing-alert / exchange-news layer for trading bots, alpha tools, news feeds and analytics. Distinct from the Binance price-ticker reader — this is Binance's announcement stream. Live from Binance; short cache only.

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

## Pricing
- **Free** (Free) — 8,400 calls/Mo, 3 req/s
- **Starter** ($9/Mo) — 158,000 calls/Mo, 10 req/s
- **Pro** ($27/Mo) — 830,000 calls/Mo, 25 req/s
- **Scale** ($80/Mo) — 5,200,000 calls/Mo, 60 req/s

## Endpoints

### Listings

#### `GET /v1/listings` — Latest new cryptocurrency listings on Binance

**Parameters:**
- `limit` (query, optional, string) — Max items (1-50) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/binanceannouncements-api/v1/listings?limit=20"
```

**Response:**
```json
{
    "data": {
        "note": "The latest new cryptocurrency listings announced on Binance, newest first — each with the listing title (the asset and where it lists), publish time and the announcement URL. A new Binance listing routinely front-runs a price spike; this is the alert feed.",
        "count": 20,
        "source": "Binance",
        "category": "New Cryptocurrency Listing",
        "listings": [
            {
                "id": 276964,
                "url": "https://www.binance.com/en/support/announcement/191cb96109f24c5c85362631a55a45d3",
                "title": "Binance Exchange Adds bStocks Tokenized Securities SpaceX (SPCXB) on Binance Spot - 2026-06-12",
                "category": "New Cryptocurrency Listing",
                "catalog_id": 48,
                "published_at": "2026-06-12T16:00:00.917Z",
                "release_date": 1781280000917
            },
            {
                "id": 276672,
                "url": "https://www.binance.com/en/support/announcement/5646e3f9ea6b4c989cb76aa18bd99245",
                "title": "Binance Exchange Adds bStocks Tokenized Securities Trading Pair(s) & Trading Bots Services on Binance Spot - 2026-06-11",
                "category": "New Cryptocurrency Listing",
                "catalog_id": 48,
                "published_at": "2026-06-11T14:05:06.698Z",
                "release_date": 1781186706698
            },
            {
                "id": 276722,
                "url": "https://www.binan
…(truncated, see openapi.json for full schema)
```

### Announcements

#### `GET /v1/announcements` — Announcements in any category

**Parameters:**
- `catalog_id` (query, optional, string) — Category id (see /v1/catalogs) Example: `48`
- `limit` (query, optional, string) — Max items (1-50) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/binanceannouncements-api/v1/announcements?catalog_id=48&limit=20"
```

**Response:**
```json
{
    "data": {
        "note": "Binance announcements in one category — each with its title, publish time and the direct announcement URL. Pass catalog_id (see /v1/catalogs; default 48 = New Cryptocurrency Listing). New-listing and delisting posts routinely move markets.",
        "count": 20,
        "source": "Binance",
        "category": "New Cryptocurrency Listing",
        "catalog_id": 48,
        "announcements": [
            {
                "id": 276964,
                "url": "https://www.binance.com/en/support/announcement/191cb96109f24c5c85362631a55a45d3",
                "title": "Binance Exchange Adds bStocks Tokenized Securities SpaceX (SPCXB) on Binance Spot - 2026-06-12",
                "category": "New Cryptocurrency Listing",
                "catalog_id": 48,
                "published_at": "2026-06-12T16:00:00.917Z",
                "release_date": 1781280000917
            },
            {
                "id": 276672,
                "url": "https://www.binance.com/en/support/announcement/5646e3f9ea6b4c989cb76aa18bd99245",
                "title": "Binance Exchange Adds bStocks Tokenized Securities Trading Pair(s) & Trading Bots Services on Binance Spot - 2026-06-11",
                "category": "New Cryptocurrency Listing",
                "catalog_id": 48,
                "published_at": "2026-06-11T14:05:06.698Z",
                "release_date": 1781186706698
            },
            {
                "id": 276722,
                "url": "htt
…(truncated, see openapi.json for full schema)
```

### Latest

#### `GET /v1/latest` — Merged latest announcements across categories

**Parameters:**
- `limit` (query, optional, string) — Max items (1-60) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/binanceannouncements-api/v1/latest?limit=25"
```

**Response:**
```json
{
    "data": {
        "note": "The merged latest Binance announcements across the key categories — new listings, news, delistings and activities — newest first, each tagged with its category. The single feed of everything happening on Binance right now.",
        "count": 25,
        "source": "Binance",
        "announcements": [
            {
                "id": 276964,
                "url": "https://www.binance.com/en/support/announcement/191cb96109f24c5c85362631a55a45d3",
                "title": "Binance Exchange Adds bStocks Tokenized Securities SpaceX (SPCXB) on Binance Spot - 2026-06-12",
                "category": "New Cryptocurrency Listing",
                "catalog_id": 48,
                "published_at": "2026-06-12T16:00:00.917Z",
                "release_date": 1781280000917
            },
            {
                "id": 276961,
                "url": "https://www.binance.com/en/support/announcement/8ad8bd3442964b3c90e67ee3de96ec0e",
                "title": "Binance Futures Will Convert SPCXUSDT Pre-IPO Perp to Standard USDⓈ-Margined TradFi Perp (2026-06-12)",
                "category": "Latest Activities",
                "catalog_id": 49,
                "published_at": "2026-06-12T15:53:56.387Z",
                "release_date": 1781279636387
            },
            {
                "id": 276960,
                "url": "https://www.binance.com/en/support/announcement/73745bb4cc9d49528cfb2b3f2b354f0f",
                "title": "Important 
…(truncated, see openapi.json for full schema)
```

### Catalogs

#### `GET /v1/catalogs` — Announcement categories

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

**Response:**
```json
{
    "data": {
        "note": "The Binance announcement categories — each with its numeric catalog id and name. Pass a catalog_id to /v1/announcements to read that category. The feed also has other catalog ids beyond this headline set.",
        "count": 6,
        "source": "Binance",
        "catalogs": [
            {
                "id": 48,
                "name": "New Cryptocurrency Listing"
            },
            {
                "id": 161,
                "name": "Latest Binance News"
            },
            {
                "id": 157,
                "name": "New Fiat Listings"
            },
            {
                "id": 93,
                "name": "Delisting"
            },
            {
                "id": 49,
                "name": "Latest Activities"
            },
            {
                "id": 51,
                "name": "API Updates"
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-14T17:03:39.971Z",
        "request_id": "37741559-83bf-46ed-bfc9-9249465392de"
    },
    "status": "ok",
    "message": "Catalogs retrieved successfully",
    "success": true
}
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "sample": {
            "latest_listing": "Binance Exchange Adds bStocks Tokenized Securities SpaceX (SPCXB) on Binance Spot - 2026-06-12"
        },
        "source": "Binance public CMS announcement API (binance.com/bapi), keyless",
        "service": "binanceannouncements-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/latest": "Merged latest announcements across key categories (limit).",
            "GET /v1/catalogs": "The announcement categories (id → name).",
            "GET /v1/listings": "The latest new cryptocurrency listings on Binance (limit).",
            "GET /v1/announcements": "Announcements in any category (catalog_id, limit)."
        },
        "description": "Live Binance announcements with no key: the latest new cryptocurrency listings, the announcements in any category (listings, delistings, news, activities), and the merged latest stream across categories — each with title, category, publish time and the announcement URL. The listing-alert / exchange-news layer for trading bots, alpha tools and news feeds. Live, short cache only.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-14T17:03:40.067Z",
        "request_id": "d32d3fe1-759b-48c6-b125-9868a0d6022c"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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