Skip to content
Exchange coverage

Bithumb listing alerts

Receive Bithumb spot listings and trading-support termination announcements with parsed tickers, the original Korean title and the notice URL.

Bithumb events we send

Scroll horizontally to compare all columns.

Values in parser.classification
Noticeeventtype
New trading supportlistingspot
Trading support terminateddelistingspot

Low-latency Bithumb listing alerts

Our low-latency detection covers Bithumb and the other supported exchanges. /v2/fast sends the raw notice before parsing; /v2/full sends the classified event for your trading client.

Real Bithumb notices

Published listings with illustrative v2 full JSON excerpts for paid keys, including contract data recorded in Tokyo. Event IDs, timestamps and market metrics are omitted. Dates are publication dates in UTC.

  • $DEBIT listed on Bithumb spot
    v2 JSON example
    {
      "type": "announcement",
      "url": "https://feed.bithumb.com/notice/1654813",
      "content": {
        "title": "텔러파이낸스(DEBIT) 원화 마켓 추가"
      },
      "parser": {
        "exchange": "bithumb",
        "classification": {
          "event": "listing",
          "type": "spot",
          "category": "crypto"
        },
        "display": "$DEBIT listed on Bithumb spot",
        "assets": [
          {
            "symbol": "DEBIT",
            "contracts": [],
            "suggested_match": {
              "confidence": "high",
              "project_name": "Teller",
              "suggested_contracts": [
                {
                  "chain": "bsc",
                  "contract": "0x66661c7229901f568f16bd1551b3ba826f83ce49"
                }
              ]
            }
          }
        ]
      }
    }
  • $USELESS listed on Bithumb spot
    v2 JSON example
    {
      "type": "announcement",
      "url": "https://feed.bithumb.com/notice/1654782",
      "content": {
        "title": "유즈리스(USELESS) 원화 마켓 추가"
      },
      "parser": {
        "exchange": "bithumb",
        "classification": {
          "event": "listing",
          "type": "spot",
          "category": "crypto"
        },
        "display": "$USELESS listed on Bithumb spot",
        "assets": [
          {
            "symbol": "USELESS",
            "contracts": [],
            "suggested_match": {
              "confidence": "high",
              "project_name": "Useless Coin",
              "suggested_contracts": [
                {
                  "chain": "solana",
                  "contract": "Dz9mQ9NzkBcCsuGPFJ3r1bS4wgqKMHBPiVuniW8Mbonk"
                }
              ]
            }
          }
        ]
      }
    }

Filter listings or delistings

Connect to /v2/full?exchange=bithumb&type=spot. This receives both spot listings and delistings. Select the event you want with parser.classification.event.

The example accepts listing. Change that check to delisting to handle trading-support terminations. Read each ticker from parser.assets.

Node.js: Bithumb spot listings

Install ws and set NLF_API_KEY to your key. The output includes each ticker, the original notice title and its URL.

// npm install ws
const WebSocket = require("ws");

const ws = new WebSocket(
  "wss://tokyo.newlistings.pro/v2/full?exchange=bithumb&type=spot",
  { headers: {
    authorization: `Bearer ${process.env.NLF_API_KEY}`
  } }
);

ws.on("message", raw => {
  const message = JSON.parse(raw.toString());
  if (message.type === "error") {
    console.error(message.code, message.message);
    return;
  }
  const classification = message.parser?.classification;
  if (classification?.event !== "listing") return;

  for (const asset of message.parser.assets) {
    console.log({
      id: message.id,
      symbol: asset.symbol,
      type: classification.type,
      title: message.content?.title,
      url: message.url
    });
  }
});

ws.on("error", error => console.error(error.message));

Fields to use in your client

Read parser.assets for the tickers. A notice can contain several assets, so loop through the array. content.title carries the original announcement title; url links to the source.

parser.classification.event tells you whether it is a listing or delisting. parser.classification.type tells you the market or product. parser.display is the readable summary.

Keep reading

Explore the WebSocket API

Get a free key