# Full Source: [Official documentation]() 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: ```json { "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: ```json { "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: ```json { "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`. ```json { "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`. ```json { "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) ```json { "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 ```json { "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](). ```json { "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. ```json { "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. ```json { "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 } ```