Live Token Aggregator (Beta)


You can get real-time token updates for all tokens supported by our dexes. If the price changes, liquidity changes, etc., an update gets pushed.

What's different?

The live token aggregator stream provides a different type of result to the other streams- such as candles and trades- that supply updates as they arrive in the blockchain.

The live token aggregator provides a list of the top n tokens sorted along a field as desired.

On initialization, you will receive a list of those top n tokens. On an update (with a frequency 2/s), you will receive updates to tokens within that top n , as well as any tokens that should be added or removed from that list (allowing you to locally maintain a list of the top n tokens following certain conditions).

For example, you might want to maintain a list of the top 5 priced tokens that have a minimum liquidity of 5. You will receive all 5 at the start, followed by any updates to those 5 tokens, or any that should be added ore removed to maintain this top 5.

Get Started

Subprotocol headers

Unlike our other websockets, the live token aggregator updates requires a subprotocol to be set due to the high frequency and different functionality.

You need to set the following headers to your connection request:

Header nameHeader value
Sec-WebSocket-Protocoltoken.updates.v1

Configuration struct

The live token aggregator WS also uses a different configuration structure. Instead of the one sent to other WS streams, send a structure like the following:

{
  "type": "configure",
  "filters": {
    "ageBucket": "ALL",
    "minLiquidityUsd": 10000,
    "minSupply": 10000,
    "minScore": 50
  },
  "sort": { "by": "age", "dir": "desc" },
  "limit": 20
}
  • type: this is always `configure
  • filters: You can provide a list of desired filters of tokens to show from the list below.
  • sort: Pick a sorting option from the list below.
  • limit: The top limit tokens results along the sort provided will be returned.
    • This can be up to a maximum of 1000

Filters

📘

Things to keep in mind:

  • To get trades for native Solana you must use 11111111111111111111111111111111as the token mint.

Example filter configuration message:

{
  "type": "configure",
  "filters": {
    "ageBucket": "ALL",
    "minLiquidityUsd": 10000,
    "minSupply": 10000,
    "minScore": 50,
    "minVol5m": 1000
  },
  "sort": { "by": "age", "dir": "desc" },
  "limit": 20
}
NameDescription
minPriceThe minimum current USD price of a token to be included.
maxPriceThe maximum current USD price of a token to be included
minPriceChg1mThe minimum current USD price change of a token in the last minute to be included.
maxPriceChg1mThe maximum current USD price change of a token in the last minute to be included
minPriceChg5mThe minimum current USD price change of a token in the last 5 minutes to be included
maxPriceChg5mThe maximum current USD price change of a token in the last 5 minutes to be include
minAbsPriceChg1mThe minimum current absolute USD price change (positive or negative) of a token in the last minute to be included.
maxAbsPriceChg1mThe maximum current absolute USD price change (positive or negative) of a token in the last minute to be included.
minAbsPriceChg5mThe minimum current absolute USD price change (positive or negative) of a token in the last 5 minutes to be included.
maxAbsPriceChg5mThe maximum current absolute USD price change (positive or negative) of a token in the last 5 minutes to be included
minVol5mThe minimum volume traded over the past 5 minutes for a token to be included.
maxVol5mThe maximum volume traded over the past 5 minutes for a token to be included
minLiquidityUsdThe minimum liquidity (in USD) of a token to be included.
maxLiquidityUsdThe maximum liquidity (in USD) of a token to be included
minSupplyThe minimum available supply of a token to be included.
maxSupplyThe maximum available supply of a token to be included
minScoreThe minimum Vybe score (of our signature calculated metric) for a token to reach for it to be included.
ageBucketThe age of the token based on when it was created. This is one of several buckets:NEW (< 10 minutes), FRESH (10m-60m), RIPE (>10 minutes), ESTABLISHED (> 1hr), or ALL

Sorts

📘

Things to keep in mind:

  • You can sort on any of these with ASC or DESC.
  • Despite the sort being provided, the returned tokens are not guaranteed to be sorted in the response provided. However, the tokens provided are restricted to the top n along that sort.
NameDescription
vol5mThe volume of this token traded in the past 5 minutes.
liquidityUsdThe amount of tradeable liquidity of this token, in USD.
ageThe age of a token.
priceChg5mThe variance in price of this token in the past 5 minutes.
scoreThe calculated Vybe score (our signature metric) of tradeability of this token.

Response

The token aggregator stream provides a result at a rate of approximately 2/s.

Example response message:

{
    "type": "tokenUpdates",
    "ts": 1772570945,
    "seq": 0,
    "updates": [
        {
            "id": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
            "changed": {
                "id": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "price": 1.0001841046774724,
                "closePrice": 1.0005785669649163,
                "priceChg1m": -0.01186905338107943,
                "priceChg5m": 0.005415019610295708,
                "vol5m": 358270.1226499995,
                "vol1h": 5237798.02845334,
                "liquidityUsd": 477360364.6467873,
                "score": 70.0,
                "ageS": 169960270,
                "firstSeenTs": 1772447018000,
                "ts": 1772570943059,
                "seq": 1789035203,
                "symbol": "USDC",
                "name": "USD Coin",
                "supply": "9086109240.492834",
                "marketCap": null,
                "holders": 5706452.0,
                "devWalletPct": null,
                "logoUrl": "https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v/logo.png",
                "trending1hr": false,
                "kolTrader1hr": false
            },
            "ts": 1772570943059
        },
        {
            "id": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
            "changed": {
                "id": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
                "price": 0.9999842669210433,
                "closePrice": 0.9999939527930084,
                "priceChg1m": -0.005699479779100437,
                "priceChg5m": -0.0010172901089805586,
                "vol5m": 230967.3777306809,
                "vol1h": 2971207.3100411026,
                "liquidityUsd": 45669369.61714841,
                "score": 70.0,
                "ageS": 160283419,
                "firstSeenTs": 1772447020000,
                "ts": 1772570943059,
                "seq": 1789030411,
                "symbol": "USDT",
                "name": "USDT",
                "supply": "3489916258.674479",
                "marketCap": null,
                "holders": 2099042.0,
                "devWalletPct": null,
                "logoUrl": "https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB/logo.svg",
                "trending1hr": false,
                "kolTrader1hr": false
            },
            "ts": 1772570943059
        },
        {
            "id": "7vfCXTUXx5WJV5JADk17DUJ4ksgau7utNKj4b963voxs",
            "changed": {
                "id": "7vfCXTUXx5WJV5JADk17DUJ4ksgau7utNKj4b963voxs",
                "price": 1979.1027172074048,
                "closePrice": 1980.9087324261031,
                "priceChg1m": -0.0569104003867047,
                "priceChg5m": -0.2503894440696932,
                "vol5m": 37162.42295704869,
                "vol1h": 1258088.2662014978,
                "liquidityUsd": 10073543.518235382,
                "score": 51.0,
                "ageS": 140869860,
                "firstSeenTs": 1772447036000,
                "ts": 1772570943059,
                "seq": 1789034600,
                "symbol": "ETH",
                "name": "Ether (Portal)",
                "supply": "63215.10596648",
                "marketCap": null,
                "holders": 73462.0,
                "devWalletPct": null,
                "logoUrl": "https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/7vfCXTUXx5WJV5JADk17DUJ4ksgau7utNKj4b963voxs/logo.png",
                "trending1hr": true,
                "kolTrader1hr": true
            },
            "ts": 1772570943059
        },
        {
            "id": "27G8MtK7VtTcCHkpASjSDdkWWYfoqT6ggEuKidVJidD4",
            "changed": {
                "id": "27G8MtK7VtTcCHkpASjSDdkWWYfoqT6ggEuKidVJidD4",
                "price": 3.7062057314637618,
                "closePrice": 3.7069866500665545,
                "priceChg1m": -0.03059508072232024,
                "priceChg5m": -0.12010058858326056,
                "vol5m": 29451.548229883883,
                "vol1h": 767001.8293960523,
                "liquidityUsd": 5677196.9329608185,
                "score": 50.0,
                "ageS": 82893111,
                "firstSeenTs": 1772447045000,
                "ts": 1772570943059,
                "seq": 1789028398,
                "symbol": "JLP",
                "name": "Jupiter Perps",
                "supply": "301109951.867639",
                "marketCap": null,
                "holders": 59962.0,
                "devWalletPct": null,
                "logoUrl": "https://static.jup.ag/jlp/icon.png",
                "trending1hr": true,
                "kolTrader1hr": false
            },
            "ts": 1772570943059
        },
        {
            "id": "Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump",
            "changed": {
                "id": "Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump",
                "price": 0.3955482792367858,
                "closePrice": 0.3945200286665303,
                "priceChg1m": 0.06103186388337285,
                "priceChg5m": -1.0554868763716891,
                "vol5m": 127144.174859629,
                "vol1h": 1271720.7515754772,
                "liquidityUsd": 13273992.558538286,
                "score": 66.0,
                "ageS": 41387594,
                "firstSeenTs": 1772447037000,
                "ts": 1772570943059,
                "seq": 1789034014,
                "symbol": "pippin",
                "name": "Pippin",
                "supply": "999937479.564133",
                "marketCap": null,
                "holders": 39359.0,
                "devWalletPct": null,
                "logoUrl": "https://ipfs.io/ipfs/QmdcvSSBg7gWD4tvfXv3PuLtAiPyDZ5Z9w4LQVeRJKL3Lz",
                "trending1hr": true,
                "kolTrader1hr": true
            },
            "ts": 1772570943059
        },
        {
            "id": "2u1tszSeqZ3qBWF3uNGPFc8TzMk2tdiwknnRMWGWjGWH",
            "changed": {
                "id": "2u1tszSeqZ3qBWF3uNGPFc8TzMk2tdiwknnRMWGWjGWH",
                "price": 1.0000915074011514,
                "closePrice": 1.000093686300875,
                "priceChg1m": -0.030898198486484073,
                "priceChg5m": 0.003303404567124283,
                "vol5m": 61503.93749500002,
                "vol1h": 649329.7812890001,
                "liquidityUsd": 28242073.938685,
                "score": 55.0,
                "ageS": 36382232,
                "firstSeenTs": 1772447032000,
                "ts": 1772570943059,
                "seq": 1789032614,
                "symbol": "USDG",
                "name": "Global Dollar",
                "supply": "1021172047.670195",
                "marketCap": null,
                "holders": 3627.0,
                "devWalletPct": null,
                "logoUrl": "https://424565.fs1.hubspotusercontent-na1.net/hubfs/424565/GDN-USDG-Token-512x512.png",
                "trending1hr": false,
                "kolTrader1hr": false
            },
            "ts": 1772570943059
        },
        {
            "id": "6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN",
            "changed": {
                "id": "6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN",
                "price": 3.4087360126297717,
                "closePrice": 3.408417581366729,
                "priceChg1m": 8.19073058162617e-6,
                "priceChg5m": -0.08767843355912956,
                "vol5m": 92234.26415763603,
                "vol1h": 833938.3276111147,
                "liquidityUsd": 21071349.418156724,
                "score": 60.0,
                "ageS": 35448484,
                "firstSeenTs": 1772447038000,
                "ts": 1772570943059,
                "seq": 1789036126,
                "symbol": "TRUMP",
                "name": "OFFICIAL TRUMP",
                "supply": "999999167.195919",
                "marketCap": null,
                "holders": 627110.0,
                "devWalletPct": null,
                "logoUrl": "https://arweave.net/VQrPjACwnQRmxdKBTqNwPiyo65x7LAT773t8Kd7YBzw",
                "trending1hr": true,
                "kolTrader1hr": false
            },
            "ts": 1772570943059
        },
        {
            "id": "5Y8NV33Vv7WbnLfq3zBcKSdYPrk7g2KoiQoe7M2tcxp5",
            "changed": {
                "id": "5Y8NV33Vv7WbnLfq3zBcKSdYPrk7g2KoiQoe7M2tcxp5",
                "price": 1.0804556837366068,
                "closePrice": 1.0804554038232448,
                "priceChg1m": -0.000010850252506677403,
                "priceChg5m": -0.04216078762725589,
                "vol5m": 107681.392522,
                "vol1h": 113890.99556940468,
                "liquidityUsd": 8131449.547630667,
                "score": 63.0,
                "ageS": 28774174,
                "firstSeenTs": 1772447099000,
                "ts": 1772570943059,
                "seq": 1789032302,
                "symbol": "ONyc",
                "name": "Onchain Yield Coin",
                "supply": "109302279.60189445",
                "marketCap": null,
                "holders": 5008.0,
                "devWalletPct": null,
                "logoUrl": "https://arweave.net/oPxfqB8PU2b48pc_emrhzAl5MkfDrmeNxoETRh3mUBw",
                "trending1hr": true,
                "kolTrader1hr": true
            },
            "ts": 1772570943059
        },
        {
            "id": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
            "changed": {
                "id": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
                "price": 0.0019195294376679905,
                "closePrice": 0.0019202831248881335,
                "priceChg1m": -0.030139330958619093,
                "priceChg5m": -0.16454913835027557,
                "vol5m": 35729.378750156,
                "vol1h": 367033.54526509537,
                "liquidityUsd": 18919402.272239752,
                "score": 51.0,
                "ageS": 20417915,
                "firstSeenTs": 1772447036000,
                "ts": 1772570943059,
                "seq": 1789031543,
                "symbol": "PUMP",
                "name": "Pump",
                "supply": "999989194228.8116",
                "marketCap": null,
                "holders": 17455.0,
                "devWalletPct": null,
                "logoUrl": "https://ipfs.io/ipfs/bafkreibyb3hcn7gglvdqpmklfev3fut3eqv3kje54l3to3xzxxbgpt5wjm",
                "trending1hr": true,
                "kolTrader1hr": false
            },
            "ts": 1772570943059
        },
        {
            "id": "USD1ttGY1N17NEEHLmELoaybftRBUSErhqYiQzvEmuB",
            "changed": {
                "id": "USD1ttGY1N17NEEHLmELoaybftRBUSErhqYiQzvEmuB",
                "price": 0.999429424512768,
                "closePrice": 0.9994309514290262,
                "priceChg1m": -0.0017090279977632662,
                "priceChg5m": -0.000991771043991433,
                "vol5m": 156399.503311,
                "vol1h": 1903237.13991,
                "liquidityUsd": 22798863.730608743,
                "score": 70.0,
                "ageS": 20042883,
                "firstSeenTs": 1772447038000,
                "ts": 1772570943059,
                "seq": 1789036503,
                "symbol": "USD1",
                "name": "World Liberty Financial USD",
                "supply": "850250429.493333",
                "marketCap": null,
                "holders": 39189.0,
                "devWalletPct": null,
                "logoUrl": "https://raw.githubusercontent.com/worldliberty/usd1-metadata/refs/heads/main/logo.png",
                "trending1hr": false,
                "kolTrader1hr": false
            },
            "ts": 1772570943059
        },
        {
            "id": "98sMhvDwXj1RQi5c5Mndm3vPe9cBqPrbLaufMXFNMh5g",
            "changed": {
                "id": "98sMhvDwXj1RQi5c5Mndm3vPe9cBqPrbLaufMXFNMh5g",
                "price": 31.571161047842683,
                "closePrice": 31.57153405440091,
                "priceChg1m": -0.049624305085812906,
                "priceChg5m": -0.24649805016905305,
                "vol5m": 37451.64460991505,
                "vol1h": 316577.3005188547,
                "liquidityUsd": 2965677.6723513096,
                "score": 51.0,
                "ageS": 12630828,
                "firstSeenTs": 1772447059000,
                "ts": 1772570943059,
                "seq": 1789031860,
                "symbol": "HYPE",
                "name": "HYPE",
                "supply": "315139.439711649",
                "marketCap": null,
                "holders": 6586.0,
                "devWalletPct": null,
                "logoUrl": "https://arweave.net/QBRdRop8wI4PpScSRTKyibv-fQuYBua-WOvC7tuJyJo",
                "trending1hr": true,
                "kolTrader1hr": false
            },
            "ts": 1772570943059
        },
        {
            "id": "8jiVXftnn2ZG6bugK7HAH5j2G3D6TpsG521gqsWwpump",
            "changed": {
                "id": "8jiVXftnn2ZG6bugK7HAH5j2G3D6TpsG521gqsWwpump",
                "price": 0.004355883124317534,
                "closePrice": 0.0043537361390603305,
                "priceChg1m": 0.8575920190945937,
                "priceChg5m": 9.946787918063457,
                "vol5m": 31631.878629402858,
                "vol1h": 126008.41636701972,
                "liquidityUsd": 588972.8604648527,
                "score": 65.0,
                "ageS": 686914,
                "firstSeenTs": 1772447020000,
                "ts": 1772570943059,
                "seq": 1789036088,
                "symbol": "AUTISM",
                "name": "Autism Coin",
                "supply": "999989809.621081",
                "marketCap": null,
                "holders": 9394.0,
                "devWalletPct": null,
                "logoUrl": "https://ipfs.io/ipfs/bafybeifp3tgsri6xx6xhquobqjsdtrwnvionvsfitfspeaa3aq4rcpqzoe",
                "trending1hr": true,
                "kolTrader1hr": true
            },
            "ts": 1772570943059
        },
        {
            "id": "5Y56iKkTt3koroW556WYb8bBgCxMnKyW3A6RMN5zRgsn",
            "changed": {
                "id": "5Y56iKkTt3koroW556WYb8bBgCxMnKyW3A6RMN5zRgsn",
                "price": 0.000049224781850305576,
                "closePrice": 0.00005007829667185316,
                "priceChg1m": 2.6740792031179494,
                "priceChg5m": 26.82459530568434,
                "vol5m": 202610.9086866644,
                "vol1h": 1787172.573205178,
                "liquidityUsd": 53947.79793102651,
                "score": 60.0,
                "ageS": 14331,
                "firstSeenTs": 1772556639000,
                "ts": 1772570943059,
                "seq": 1789032816,
                "symbol": "DANDAN",
                "name": "the new doge",
                "supply": "1000000008",
                "marketCap": null,
                "holders": 1226.0,
                "devWalletPct": null,
                "logoUrl": "https://pbs.twimg.com/profile_images/2028723163933114368/-9yywK_s_400x400.jpg",
                "trending1hr": true,
                "kolTrader1hr": false
            },
            "ts": 1772570943059
        },
        {
            "id": "DLCiqcXXEiperjFHty3AtK38KrGLeGCzYSjArARCV635",
            "changed": {
                "id": "DLCiqcXXEiperjFHty3AtK38KrGLeGCzYSjArARCV635",
                "price": 0.000048236509233691616,
                "closePrice": 0.00004885535084124327,
                "priceChg1m": -1.1502419047157169,
                "priceChg5m": 14.780256073955895,
                "vol5m": 203045.3007150989,
                "vol1h": 2148395.3942926414,
                "liquidityUsd": 68381.35329185313,
                "score": 53.0,
                "ageS": 7203,
                "firstSeenTs": 1772563756000,
                "ts": 1772570943059,
                "seq": 1789030166,
                "symbol": "AIBinance",
                "name": "AIBinance",
                "supply": "1000000000",
                "marketCap": null,
                "holders": 4945.0,
                "devWalletPct": null,
                "logoUrl": "https://ipfs.io/ipfs/QmU1z1nUUG6FN2SDJRbiiPL5KLtuzJtrxyRmwovYipDNvD",
                "trending1hr": false,
                "kolTrader1hr": false
            },
            "ts": 1772570943059
        },
        {
            "id": "BPwVDniJozrxkkd2bH7WUQx7US8XjVojCSA8NRYz3xnJ",
            "changed": {
                "id": "BPwVDniJozrxkkd2bH7WUQx7US8XjVojCSA8NRYz3xnJ",
                "price": 0.00020917421319121936,
                "closePrice": 0.00020967632998259697,
                "priceChg1m": 0.8554988220466329,
                "priceChg5m": -2.1509236879042586,
                "vol5m": 841102.062710882,
                "vol1h": 8837614.006014466,
                "liquidityUsd": 284299.726672599,
                "score": 51.0,
                "ageS": 6306,
                "firstSeenTs": 1772564711000,
                "ts": 1772570943059,
                "seq": 1789026559,
                "symbol": "SATRIX600",
                "name": "SATRIX_SA",
                "supply": "1000000001",
                "marketCap": null,
                "holders": 1947.0,
                "devWalletPct": null,
                "logoUrl": "https://ipfs.io/ipfs/QmYDZEQRPuWy9CkoM6k6BYZAcnVoifPDioLZwDqBazfRY8",
                "trending1hr": false,
                "kolTrader1hr": false
            },
            "ts": 1772570943059
        },
        {
            "id": "Fy6Y14Kxfw17Yd94kAuZcQqTAepTLm6nT5i1ufaRde6L",
            "changed": {
                "id": "Fy6Y14Kxfw17Yd94kAuZcQqTAepTLm6nT5i1ufaRde6L",
                "price": 0.0002020933500438462,
                "closePrice": 0.0002028386816787809,
                "priceChg1m": 0.6837967964514031,
                "priceChg5m": 5.341736525991175,
                "vol5m": 767621.6074219594,
                "vol1h": 7853776.243861718,
                "liquidityUsd": 251030.15196205903,
                "score": 56.0,
                "ageS": 5866,
                "firstSeenTs": 1772565130000,
                "ts": 1772570943059,
                "seq": 1789033300,
                "symbol": "OPN",
                "name": "opinionlabsxyz",
                "supply": "1000000001",
                "marketCap": null,
                "holders": 2924.0,
                "devWalletPct": null,
                "logoUrl": "https://ipfs.io/ipfs/QmWdEP5nbrfz11xMN4apEarKbcgFKPhRSeZSBn8GDqtaVA",
                "trending1hr": false,
                "kolTrader1hr": false
            },
            "ts": 1772570943059
        },
        {
            "id": "CSidETo7afSes1tcdYFfijozA46MaSZHhFAmJuDUsKZ6",
            "changed": {
                "id": "CSidETo7afSes1tcdYFfijozA46MaSZHhFAmJuDUsKZ6",
                "price": 0.0000760443987801826,
                "closePrice": 0.00007579962380646511,
                "priceChg1m": 8.801476045338262,
                "priceChg5m": 20.73269271432502,
                "vol5m": 482271.6488630898,
                "vol1h": 5091405.546370508,
                "liquidityUsd": 100110.80699015986,
                "score": 64.0,
                "ageS": 4818,
                "firstSeenTs": 1772566173000,
                "ts": 1772570943059,
                "seq": 1789035238,
                "symbol": "6G",
                "name": "6G",
                "supply": "1000000001",
                "marketCap": null,
                "holders": 741.0,
                "devWalletPct": null,
                "logoUrl": "https://ipfs.io/ipfs/QmYTa7iRSwzKA8RYaBczKdGgEe9LVTSdCR1SiKWp1dftpE",
                "trending1hr": false,
                "kolTrader1hr": false
            },
            "ts": 1772570943059
        },
        {
            "id": "FqiH6vwgandtHHiaH1ZdC9m6RC4PA7xaBraZFSX6PGWk",
            "changed": {
                "id": "FqiH6vwgandtHHiaH1ZdC9m6RC4PA7xaBraZFSX6PGWk",
                "price": 0.00008994857614594873,
                "closePrice": 0.00008934477645763571,
                "priceChg1m": -1.7603701873900992,
                "priceChg5m": 9.231799215607769,
                "vol5m": 204871.7027694119,
                "vol1h": 1938107.794184348,
                "liquidityUsd": 125174.14863527151,
                "score": 50.0,
                "ageS": 4132,
                "firstSeenTs": 1772566830000,
                "ts": 1772570943059,
                "seq": 1789036734,
                "symbol": "WWIII",
                "name": "World War III",
                "supply": "1000000000",
                "marketCap": null,
                "holders": 2583.0,
                "devWalletPct": null,
                "logoUrl": "https://ipfs.io/ipfs/QmZ8WsK5GaBmzxYUrYAmuq6BmWWQQKLq2t2jSDENyBjiMr",
                "trending1hr": false,
                "kolTrader1hr": false
            },
            "ts": 1772570943059
        },
        {
            "id": "2HTkVbNru4hMKRdgeNKWC7KBiQ5u8bm4FsrvnAowtNwP",
            "changed": {
                "id": "2HTkVbNru4hMKRdgeNKWC7KBiQ5u8bm4FsrvnAowtNwP",
                "price": 0.000055272201081472005,
                "closePrice": 0.00005420989286678058,
                "priceChg1m": 0.8628855839006175,
                "priceChg5m": 8.377464874811238,
                "vol5m": 893688.7197078132,
                "vol1h": 7926048.684539418,
                "liquidityUsd": 80142.7072691889,
                "score": 55.0,
                "ageS": 3144,
                "firstSeenTs": 1772567828000,
                "ts": 1772570943059,
                "seq": 1789036305,
                "symbol": "BELLICOSUS",
                "name": "Bellicosus",
                "supply": "1000000001",
                "marketCap": null,
                "holders": 2015.0,
                "devWalletPct": null,
                "logoUrl": "https://ipfs.io/ipfs/QmUDpoZss7rCpqyo65emKNy39an5kkRbDGeXvLYgajVm1t",
                "trending1hr": false,
                "kolTrader1hr": false
            },
            "ts": 1772570943059
        },
        {
            "id": "HG2vUfCNQmwndgNPr6P3DX3TK9cAc5h4LHZBXgVLP8CJ",
            "changed": {
                "id": "HG2vUfCNQmwndgNPr6P3DX3TK9cAc5h4LHZBXgVLP8CJ",
                "price": 0.00009501699297368532,
                "closePrice": 0.00009359952434553212,
                "priceChg1m": 3.2661529501137445,
                "priceChg5m": 10.165184630243855,
                "vol5m": 472384.66570383706,
                "vol1h": 3824789.0125474418,
                "liquidityUsd": 102432.0782652386,
                "score": 59.0,
                "ageS": 3010,
                "firstSeenTs": 1772567957000,
                "ts": 1772570943059,
                "seq": 1789029890,
                "symbol": "GOLD",
                "name": "GOLD",
                "supply": "1000000001",
                "marketCap": null,
                "holders": 937.0,
                "devWalletPct": null,
                "logoUrl": "https://ipfs.io/ipfs/QmPNr1cJEHLcgUi71QUBuhbbiHqU4pD9URoPVQUNPtvTFN",
                "trending1hr": false,
                "kolTrader1hr": false
            },
            "ts": 1772570943059
        }
    ],
    "deletes": []
}

It has the following values:

  • type: token_updates
  • ts: The time of emission.
  • seq: A deprecated value that can and should be ignored.
  • updates: A list of tokens that should be considered in the top n. If this is the first response, this should have the same number of rows as limit (unless the filters were too strict). On any future message, a token in updates will be either:
    • A token that is newly part of that top n (for example, if it increased along the sort metric, or a higher token decreased along that metric).
    • A token that is already in the top n that has updated.
  • deletes: A list of mints that are no longer in the top n that were in the top n before this message, and should no longer be considered.

Overview of the token update structure in updates:

NameDescription
idThe mint address of the token in question.
priceThe price in USD of the token at this time stamp.
priceChg1mThe variance in the USD price of the token in the past 1 minute.
priceChg5mThe variance in the USD price of the token in the past 5 minutes.
vol5mThe volume of the token traded in the past 5 minutes.
vol1hThe volume of the token traded in the past 60 minutes.
liquidityUsdThe liquidity of the token in USD.
scoreThe calculated Vybe score (our signature metric) of tradeability of this token
ageSThe age of the token, in seconds.
firstSeenTsThe timestamp this token was first seen by our aggregator (within our aggregators buffer- this will always be a relatively recent value).
tsThe timestamp of the update.
seqA deprecated value to be ignored.
symbolThe symbol of the token.
nameThe name of the token.
supplyThe total supply of the token available.
logoUrlThe URL pointing to the logo of the token.