New Listings Feed · v2 Full WebSocket: Parsed Listing Events

Key	WebSocket URL
FREE	`wss://ws.newlistings.pro/v2/full`
STARTER, PRO	`wss://tokyo.newlistings.pro/v2/full`, `wss://ny.newlistings.pro/v2/full` or `wss://seoul.newlistings.pro/v2/full`

Full sends parsed events.

Response fields by key

Fields marked Yes are included when available.

Response data	FREE	STARTER	PRO
Event ID, source URL, and timestamps	Yes	Yes	Yes
Classification and ticker symbols	Yes	Yes	Yes
Tweet username	Yes	Yes	Yes
Announcement title	When available	When available	When available
Tweet text (`content.text`)	Yes	Yes	Yes
Project name and metrics	No	Yes	Yes
Confirmed contracts and DEX pairs	No	Yes	Yes
Suggested project matches	No	Yes	Yes

Event fields

Field	Type	Notes
`id`	integer	Opaque event ID for this edge and endpoint.
`type`	string	`announcement` or `tweet`.
`username`	string	Present on a `tweet` when available.
`url`	string	Source URL.
`content`	object	Optional source fields. See Source content.
`parser`	object	Exchange, classification, optional display text, and assets.
`detected_time_us`	integer	Detection time as Unix epoch microseconds.
`sent_time_us`	integer	Publication time as Unix epoch microseconds, set during serialization after the plan delay.

Do not use id to join or deduplicate events across Full, Fast or regional edges. IDs are allocated independently. The publication timestamp is not confirmation of a completed socket write; see Measure delivery.

Source content

When present, announcement content contains only title.

Field	Description
`title`	Announcement title
`text`	Tweet text

`parser`

Field	Type	Notes
`exchange`	string	Lowercase exchange identifier.
`classification`	object	Event classification.
`display`	string	Short parsed text, present on a classified event when available.
`assets`	array	Detected assets. Empty when no assets were detected.

`parser.classification`

Field	Type	Notes
`event`	string	`listing`, `delisting`, or `none`.
`type`	string	Market or product type. Present for listings and delistings.
`category`	string	`crypto` or `rwa`. Present for listings and delistings. Classified events use `crypto`; `rwa` is reserved.
`markets`	string[]	Upbit spot listings only. Quote markets read from the notice, such as `["krw", "btc", "usdt"]`. Omitted when unavailable.

An unclassified notice has this parser result:

{
  "exchange": "upbit",
  "classification": { "event": "none" },
  "assets": []
}

`parser.assets[]`

Field	Type	Notes
`symbol`	string	Detected ticker.
`name`	string	Project name, when available.
`contracts`	array	Confirmed contracts. Empty when none are available.
`metrics`	object	Market cap, FDV, and supply values when available.
`suggested_match`	object	A candidate project match when `contracts` is empty.

`parser.assets[].contracts[]`

Confirmed contracts contain chain, contract, and optional dex_pairs. Each DEX pair contains dex_id, pair, pair_contract, volume_24h_usd, and liquidity_usd.

`metrics`

Metrics appear on an asset or its suggested match when available. The fields are circulating_market_cap_usd, fdv_usd, circulating_supply, and total_supply.

`parser.assets[].suggested_match`

A candidate may appear when contracts is empty. It is not a confirmed match.

Field	Type	Notes
`confidence`	string	`medium`, `high`, or `very high`.
`project_name`	string	Project selected by the matcher.
`metrics`	object	Market cap, FDV, and supply values when available.
`suggested_contracts`	array	One or more candidate contracts. Each entry contains only `chain` and `contract`.

suggested_contracts do not establish that the exchange supports deposits or withdrawals on those chains.

Examples

Suggested match: STARTER/PRO key event

In this paid key example, no contract was confirmed by the source. contracts is empty and the matcher attached a candidate under suggested_match.

{
  "id": 3663901906511872,
  "type": "announcement",
  "url": "https://upbit.com/service_center/notice?id=26668186",
  "content": {
    "title": "렌조(REZ) 신규 거래지원 안내 (USDT 마켓)"
  },
  "parser": {
    "exchange": "upbit",
    "classification": {
      "event": "listing",
      "type": "spot",
      "category": "crypto",
      "markets": [
        "usdt"
      ]
    },
    "display": "$REZ listed on Upbit spot",
    "assets": [
      {
        "symbol": "REZ",
        "contracts": [],
        "suggested_match": {
          "confidence": "high",
          "project_name": "Renzo",
          "metrics": {
            "circulating_market_cap_usd": 27000000,
            "fdv_usd": 30000000,
            "circulating_supply": 8875943328,
            "total_supply": 9814629224
          },
          "suggested_contracts": [
            {
              "chain": "ethereum",
              "contract": "0x3b50805453023a91a8bf641e279401a0b23fa6f9"
            }
          ]
        }
      }
    ]
  },
  "detected_time_us": 1789014602789862,
  "sent_time_us": 1789014602792927
}

Optional fields are omitted when the data is not available.

Confirmed contract: STARTER/PRO key event

When the source provides a confirmed contract, it stays under contracts. The Full response omits suggested_match when confirmed contracts are present. Available project data appears under name and metrics.

{
  "id": 3663776607637504,
  "type": "announcement",
  "url": "https://www.binance.com/en/support/announcement/list/48",
  "parser": {
    "exchange": "binance",
    "classification": {
      "event": "listing",
      "type": "spot",
      "category": "crypto"
    },
    "display": "$牛来 listed on Binance spot",
    "assets": [
      {
        "symbol": "牛来",
        "name": "牛来 (Niu Lai)",
        "contracts": [
          {
            "chain": "bsc",
            "contract": "0xbeea1d618e533a387d941f58a7d4c9b7bd377777",
            "dex_pairs": [
              {
                "dex_id": "pancakeswap-v3-bsc",
                "pair": "牛来/usdt",
                "pair_contract": "0xe5ae318389b8d6d09370a675479c64862152d126",
                "volume_24h_usd": 19000000,
                "liquidity_usd": 850000
              }
            ]
          }
        ],
        "metrics": {
          "circulating_market_cap_usd": 120000000,
          "fdv_usd": 120000000,
          "circulating_supply": 1000000000,
          "total_supply": 1000000000
        }
      }
    ]
  },
  "detected_time_us": 1788953421698590,
  "sent_time_us": 1788953421706879
}

Exchange post: FREE key event

Illustrative FREE response based on a recorded post.

{
  "id": 3663209129480192,
  "type": "tweet",
  "username": "BinanceWallet",
  "url": "https://x.com/BinanceWallet/status/2096486606060548208",
  "content": {
    "text": "Binance Alpha will be the first platform to feature Canopy (CNPY) on September 7. Eligible users can claim their airdrop using Binance Alpha Points on the Alpha Events page once trading opens. Further details will be announced soon. Please stay tuned to Binance’s official…"
  },
  "parser": {
    "exchange": "binance",
    "classification": {
      "event": "listing",
      "type": "alpha",
      "category": "crypto"
    },
    "display": "$CNPY featured on Binance alpha",
    "assets": [
      {
        "symbol": "CNPY"
      }
    ]
  },
  "detected_time_us": 1788676332754529,
  "sent_time_us": 1788676335754529
}

Filters

wss://tokyo.newlistings.pro/v2/full?exchange=upbit&data_type=announcement&market_type=spot
wss://tokyo.newlistings.pro/v2/full?market_type=spot,futures
wss://tokyo.newlistings.pro/v2/full?data_type=tweet&username=BinanceWallet

Filters are fixed when you connect. Use exchange, data_type, market_type, and username as described in Filters and coverage. Different parameters combine with AND. exchange, data_type, and market_type accept comma-separated values; username accepts one handle.

The query is limited to 1,024 bytes. Each exchange value and the username are limited to 64 bytes. Empty values, repeated parameters, unknown parameter names, contradictory filters and malformed percent escapes return 400 INVALID_REQUEST.