New Listings Feed · v2 Full WebSocket: Parsed Listing Events

New Listings Feed's /v2/full stream sends parsed exchange announcements and X posts with classification, ticker symbols and event timestamps; paid keys add available metrics and onchain data.

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`

Filter the stream with exchange, data_type, market_type, category and username in the connection URL. See Filters and coverage.

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
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, after any plan delay.

Do not use id to join or deduplicate events across Full, Fast or regional edges. IDs are allocated independently. See Measure delivery before interpreting the timestamps.

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`, `caution`, or `none`.
`type`	string	Market or product type, such as `spot` or `futures`. On a caution, the action: `designated`, `extended`, `lifted` or `warning`. See Exchange coverage for the values.
`category`	string	`crypto` or `rwa`. A connection receives `rwa` events only when it asks for them with the `category` filter.
`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.
`is_scheduled`	boolean	Binance Alpha 2.0 (`alpha-live`) assets only. `true` when the token is listed on Alpha 2.0 through a scheduled, previously announced event (such as a Binance Wallet TGE, airdrop, etc), and `false` for a fresh, surprise listing.
`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. Some pairs add more: see Robinhood and BSC DEX pairs.

DEX IDs

Chain	Common `dex_id` values
`solana`	`pumpswap`, `meteora`, `raydium`
`ethereum`	`uniswap`, `uniswap_v2`, `uniswap_v3`, `uniswap-v4-ethereum`
`bsc`	`pancakeswap`, `pancakeswap_v2`, `pancakeswap-v3-bsc`, `pancakeswap-infinity-clmm`, `uniswap`
`base`	`uniswap`, `aerodrome-base`, `aerodrome-slipstream-2`
`robinhood`	`uniswap-v2-robinhood`, `uniswap-v3-robinhood`, `uniswap-v4-robinhood`, `pons-v2-dex`, `ramses`, `sushiswap`, `uniswap`

`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 with `chain` and `contract`. `robinhood` entries can add `dex_pairs`.

Robinhood and BSC DEX pairs

Pools on robinhood and bsc contracts add the fields a swap needs. Robinhood listings carry them on the suggested contract. Pairs without protocol carry only the five base keys. Pools are ordered by volume.

Pool type

protocol names the pool type. The type decides which fields appear.

Type	Robinhood	BSC
v2	`uniswap_v2`	`pancakeswap_v2`
v3	`uniswap_v3`	`pancakeswap_v3`
Ramses	`ramses_v3`
v4	`uniswap_v4`	`pancakeswap_infinity_cl`

v2: pair_contract is the pair address. Adds currency0 and currency1. No fee field; the fee is fixed at 0.3% on Uniswap and 0.25% on PancakeSwap.
v3: pair_contract is the pool address. Adds currency0, currency1 and fee.
Ramses: pair_contract is the pool address. Adds currency0, currency1 and tick_spacing. Ramses sets the fee.
v4: pair_contract is the pool ID. Adds the pool key: currency0, currency1, fee, tick_spacing and hooks. PancakeSwap Infinity also adds parameters.

A Robinhood uniswap_v4 pool:

{
  "dex_id": "uniswap-v4-robinhood",
  "pair": "pons/usdg",
  "pair_contract": "0x486435a1f76cd58193f854c6e6213cd05fd58d637865d02065ff558b387fa6ea",
  "volume_24h_usd": 8000000,
  "liquidity_usd": 6200000,
  "depth_plus_2pct_usd": 320000,
  "depth_minus_2pct_usd": 300000,
  "protocol": "uniswap_v4",
  "currency0": "0x39dbed3a2bd333467115de45665cc57f813c4571",
  "currency1": "0x5fc5360d0400a0fd4f2af552add042d716f1d168",
  "fee": 8388608,
  "tick_spacing": 60,
  "hooks": "0x08e52564bad99e05a694b4809f397edca417a080"
}

A BSC pancakeswap_infinity_cl pool:

{
  "dex_id": "pancakeswap-infinity-clmm",
  "pair": "irys/usdt",
  "pair_contract": "0x63fff184ea44fdb427021163ab5ac4cb9d715179de0261b63e515d03af08432b",
  "volume_24h_usd": 44000,
  "liquidity_usd": 500000,
  "protocol": "pancakeswap_infinity_cl",
  "currency0": "0x55d398326f99059ff775485246999027b3197955",
  "currency1": "0x91152b4ef635403efbae860edd0f8c321d7c035d",
  "fee": 67,
  "tick_spacing": 10,
  "hooks": "0x72e09ebd9b24f47730b651889a4ed984cba53d90",
  "parameters": "0x00000000000000000000000000000000000000000000000000000000000a0055"
}

Fields

Field	Meaning
`fee`	Pool fee in hundredths of a basis point: 100 is 0.01%, 3000 is 0.3%. `8388608` means the hook sets the fee; pass it unchanged.
`currency0`	First token of the pool. All zeros is the native coin.
`currency1`	Second token of the pool.
`tick_spacing`	Tick spacing of the pool.
`hooks`	Hook contract. All zeros is no hook; otherwise the hook can change what a swap costs.
`parameters`	PancakeSwap Infinity only. Pass it unchanged in the pool key.
`depth_plus_2pct_usd`	Robinhood only. USD of buying absorbed before the token's price rises 2%.
`depth_minus_2pct_usd`	Robinhood only. USD of selling absorbed before the token's price falls 2%.

The pool manager in a PancakeSwap Infinity pool key is always 0xa0ffb9c1ce1fe56963b0321b32e7a0302114058b.

ramses_v3 pools come from the Ramses V3 factory 0xe0c4ceb92d08ca985bb70fe0a22feb121a9854a8.

Quote tokens

Native ETH appears as weth in pair, and native BNB as bnb. Check currency0.

Token	Chain	Address
WETH	Robinhood	`0x0bd7d308f8e1639fab988df18a8011f41eacad73`
USDG	Robinhood	`0x5fc5360d0400a0fd4f2af552add042d716f1d168`
WBNB	BSC	`0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c`
USDT	BSC	`0x55d398326f99059ff775485246999027b3197955`
Native ETH or BNB	Both	`0x0000000000000000000000000000000000000000`

Examples

Suggested match

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

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,
                "protocol": "pancakeswap_v3",
                "currency0": "0x55d398326f99059ff775485246999027b3197955",
                "currency1": "0xbeea1d618e533a387d941f58a7d4c9b7bd377777",
                "fee": 2500
              }
            ]
          }
        ],
        "metrics": {
          "circulating_market_cap_usd": 120000000,
          "fdv_usd": 120000000,
          "circulating_supply": 1000000000,
          "total_supply": 1000000000
        }
      }
    ]
  },
  "detected_time_us": 1788953421698590,
  "sent_time_us": 1788953421706879
}

Listing (tweet)

{
  "id": 3664821661927424,
  "type": "tweet",
  "username": "BinanceWallet",
  "url": "https://x.com/BinanceWallet/status/2099789072642474413",
  "content": {
    "text": "Binance Alpha will be the first platform to feature apM Fashion (APM) on September 17. 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": "$APM featured on Binance Alpha",
    "assets": [
      {
        "symbol": "APM",
        "name": "apM Fashion",
        "contracts": []
      }
    ]
  },
  "detected_time_us": 1789463702113900,
  "sent_time_us": 1789463702121945
}

Listing: live on Binance Alpha 2.0

{
  "id": 3663600218580993,
  "type": "announcement",
  "url": "https://www.binance.com/en/binancewallet/0x39dbed3a2bd333467115de45665cc57f813c4571",
  "content": {
    "title": "New Binance Alpha: Pons (PONS). Chain: Robinhood. Contract: 0x39dbed3a2bd333467115de45665cc57f813c4571. MC: 510338665"
  },
  "parser": {
    "assets": [
      {
        "name": "Pons",
        "symbol": "PONS",
        "is_scheduled": false,
        "metrics": {
          "fdv_usd": 490000000,
          "total_supply": 712104762,
          "circulating_supply": 712104762,
          "circulating_market_cap_usd": 500000000
        },
        "contracts": [
          {
            "chain": "robinhood",
            "contract": "0x39dbed3a2bd333467115de45665cc57f813c4571",
            "dex_pairs": [
              {
                "pair": "pons/weth",
                "dex_id": "uniswap",
                "liquidity_usd": 4100000,
                "pair_contract": "0xEd50bDeeA8aDC232f159486192a4157281D722ff",
                "volume_24h_usd": 38000000
              },
              {
                "pair": "pons/weth",
                "dex_id": "uniswap",
                "liquidity_usd": 6900000,
                "pair_contract": "0x10CC6BD38112cAc182db90B6a71d8Bb5939526bA",
                "volume_24h_usd": 9100000
              }
            ]
          }
        ]
      }
    ],
    "display": "$PONS live on Binance Alpha 2.0",
    "exchange": "binance",
    "classification": {
      "type": "alpha-live",
      "event": "listing",
      "category": "crypto"
    }
  },
  "detected_time_us": 1788867294229828,
  "sent_time_us": 1788867294238869
}

Listing: Robinhood (extended onchain data)

Robinhood listings name the contract only in suggested_match. The suggested contract carries the Robinhood DEX pair fields.

{
  "symbol": "PONS",
  "name": "Pons",
  "contracts": [],
  "suggested_match": {
    "confidence": "very high",
    "project_name": "Pons",
    "suggested_contracts": [
      {
        "chain": "robinhood",
        "contract": "0x39dbed3a2bd333467115de45665cc57f813c4571",
        "dex_pairs": [
          {
            "dex_id": "uniswap-v4-robinhood",
            "pair": "pons/usdg",
            "pair_contract": "0x486435a1f76cd58193f854c6e6213cd05fd58d637865d02065ff558b387fa6ea",
            "volume_24h_usd": 8000000,
            "liquidity_usd": 6200000,
            "depth_plus_2pct_usd": 320000,
            "depth_minus_2pct_usd": 300000,
            "protocol": "uniswap_v4",
            "currency0": "0x39dbed3a2bd333467115de45665cc57f813c4571",
            "currency1": "0x5fc5360d0400a0fd4f2af552add042d716f1d168",
            "fee": 8388608,
            "tick_spacing": 60,
            "hooks": "0x08e52564bad99e05a694b4809f397edca417a080"
          },
          {
            "dex_id": "ramses",
            "pair": "pons/usdg",
            "pair_contract": "0xf2a0be59ab76b96f957bd5e5b967f2b75e8db269",
            "volume_24h_usd": 5600000,
            "liquidity_usd": 1400000,
            "protocol": "ramses_v3",
            "currency0": "0x39dbed3a2bd333467115de45665cc57f813c4571",
            "currency1": "0x5fc5360d0400a0fd4f2af552add042d716f1d168",
            "tick_spacing": 50
          },
          {
            "dex_id": "uniswap-v3-robinhood",
            "pair": "pons/weth",
            "pair_contract": "0xed50bdeea8adc232f159486192a4157281d722ff",
            "volume_24h_usd": 3900000,
            "liquidity_usd": 4600000,
            "depth_plus_2pct_usd": 130000,
            "depth_minus_2pct_usd": 120000,
            "protocol": "uniswap_v3",
            "currency0": "0x0bd7d308f8e1639fab988df18a8011f41eacad73",
            "currency1": "0x39dbed3a2bd333467115de45665cc57f813c4571",
            "fee": 3000
          }
        ]
      }
    ]
  }
}

Regular tweet

An unclassified tweet has event: "none", no display and an empty assets array.

{
  "id": 3664886174152704,
  "type": "tweet",
  "username": "binance",
  "url": "https://x.com/binance/status/2099921192312533122",
  "content": {
    "text": "Everything TradFi. On Binance. What's your first stop? 👇"
  },
  "parser": {
    "exchange": "binance",
    "classification": {
      "event": "none"
    },
    "assets": []
  },
  "detected_time_us": 1789495202223226,
  "sent_time_us": 1789495202223914
}

Non-listing announcement

The title names ZEC, but a withdrawal suspension is not a listing, so event is none and assets is empty.

{
  "id": 3664691250239488,
  "type": "announcement",
  "url": "https://upbit.com/service_center/notice?id=944072813",
  "content": {
    "title": "지캐시(ZEC) 출금 일시 중단 안내"
  },
  "parser": {
    "exchange": "upbit",
    "classification": {
      "event": "none"
    },
    "assets": []
  },
  "detected_time_us": 1789400024531582,
  "sent_time_us": 1789400024534327
}