WebSocket API Reference
Real-time streaming data for Solana transactions and aggregated statistics with low latency and high throughput.
Connection Details
WebSocket URL:
wss://ws.aggregations.dev.lys.network/realtime-aggregationsProtocol: WebSocket (WSS for production)
Authentication: API Key via query parameter
Message Types
Token Stats Message
{
"mintId": "BjQxXBh6Pb8xDcSbgMuQdDDBNWoMVgvKrcVApmr9pump",
"priceData": {
"ath": 2.88073409323e-7,
"localAtl": 2.85307023377e-7,
"newAthCost": 0.31729594175378395
},
"volumeData": {
"buyCount": 924,
"sellCount": 24,
"buyVolume": 67.38738413300003,
"sellVolume": 1.407831243,
"proTraderBuyCount": 20
},
"holderData": {
"tokensInCirculation": 737616064.5657842,
"totalHolders": 243,
"activeHolders": 222,
"maxActiveHolders": 223,
"holdingPercentageForTopHoldersOneToTen": 99.40211845200551,
"holdingPercentageForTopHoldersElevenToTwenty": 0.047230851053880425,
"holdingPercentageForTopHoldersTwentyOneToThirty": 0.024508142834847046,
"userHoldings": {
"92s2ArkTSEDS8pz7fFdtbDCUQLrWMLqiUtnnVStgSUbv": {
"balance": 373217391.3063863,
"percentage": 50.59778511278626
},
"DwUx8j18bNzg7ERztamfoi6uTZEuNWwcJGYreYnuTecc": {
"balance": 180589060.3105943,
"percentage": 24.48279924826508
},
"HfVCGNKwGdcPu23P2kUaF6rJPJsfsWaMQEdquN1MY6SQ": {
"balance": 106501240.69682828,
"percentage": 14.438573915756953
},
"6hwT8rdKBcaJEGZvzArpSwaPRQjm5FLnqGoxkvb5K18p": {
"balance": 70245499.18370828,
"percentage": 9.523314710486956
},
"6xAUgHJSDBb9oDRTekdj3rPbHCHu8Z5i9jTzK8wi4unE": {
"balance": 901304.57845128,
"percentage": 0.12219156031828768
},
"7R9UKwY8XuSZ7nVDbnU6ZWbE5EZpw2ozWcA27JxS483h": {
"balance": 687934.16952128,
"percentage": 0.09326453185726769
},
"CKnkMFkFbuMq6h99oGWKjA1oigC272rrXgJRDqvGuyPg": {
"balance": 417602.260193,
"percentage": 0.056615125436405976
},
"Bb9ofDdkcaUZErNpcATcf1mDSQZC4uSeQq2GCNaGP8rR": {
"balance": 348450.053133,
"percentage": 0.04724003039957158
},
"9wrruPKnsjpQDwfxBkCBJ1Z2aviTK49avUaWThwt61Nt": {
"balance": 187711.76769928,
"percentage": 0.025448438112554005
},
"G8nEHkvYKe2fYaPaazhJBRGzs2w4CMTFLUwumwFdDqV8": {
"balance": 109799.89418728,
"percentage": 0.014885778586169542
},
"CMkaCp2HfEX9beaHcrnhSgD2zR5kijifiyE3mZxey6sg": {
"balance": 92020.16685028,
"percentage": 0.012475347443042734
},
"2gbM1QuSGdUoRCAD8Ede8cWp9hptXYNyXE9anCirtDdM": {
"balance": 75245.382147,
"percentage": 0.010201158266705463
},
"DecAu4W1bud8d1fmNwDshPnZfFApYgFEVfbNz5egWA54": {
"balance": 37646.80343928,
"percentage": 0.005103848092224199
},
"a2DnvESKyWintb12mP5aD3UfKxTTiLPUhJjSxsNq531": {
"balance": 23597.914976,
"percentage": 0.0031992138064253646
},
"2cPDGiioQL5HUhpSnP8qSxGH64jwCwFgdvnQ9LjWUJgM": {
"balance": 22827.754564,
"percentage": 0.003094801707909943
},
"FvfztYwxgw5oPuGybsqhJTBafS6hZvtbm5SSFna7YdkH": {
"balance": 19646.785449,
"percentage": 0.0026635517300678045
},
"ETC78Vtk8whvNAEmGbg5epBKhSPFbwYmLdK2koNDh4xi": {
"balance": 19644.389831,
"percentage": 0.0026632269516207122
},
"4RXfSVobJ914hV2yNvQPNLDqL75Z6V6SBav2zAbCGtjv": {
"balance": 19557.577888,
"percentage": 0.0026514576929005805
},
"UZ7Dg6zCdoXJzG3i7scT38GkJbuihD4K9m1M1bFuDfv": {
"balance": 19225.195911,
"percentage": 0.0026063960418645955
},
"6RToFbaooLWGeJuLFzEyq6XXMMzUiqovZJsSjb5T84PM": {
"balance": 18970.373749,
"percentage": 0.002571849321119026
},
"H7tdTftstPoNnU6tujskqw1vvsE6wZkcXZcVKGJ3N1Q9": {
"balance": 18809.643922,
"percentage": 0.002550058875557809
},
"3Y79TNo4ZAQAcGTZFMrkvaA82KcrQQdqM7Xz4mmVmoqi": {
"balance": 18676.678551,
"percentage": 0.002532032509621992
},
"DjRdzDrMTH88vUYJRwZaLeMG8c7xvAuktyBWxtftPi9g": {
"balance": 18653.428153,
"percentage": 0.002528880409346941
},
"8LZrPE3bkZGyQcKcJ7vPCUC6jSnsZ3GdAz9RsSGD5Yv2": {
"balance": 18616.256146,
"percentage": 0.0025238409303028012
},
"neZ2C8479THxjcvJZ1SkXD2u9oumRCAj9HK6nJaWDoU": {
"balance": 18583.855594,
"percentage": 0.0025194483264053967
},
"Cp5eV9mMkwPkoFtS7uLpa6gybrPBaFFkVPDKZqEwpWx6": {
"balance": 18390.768186,
"percentage": 0.0024932711026062287
},
"EK9rXpTtLKmQMA6qkptpGMLkVW5fB9yqTQNoCDKDn1Jb": {
"balance": 18372.397394,
"percentage": 0.002490780539712806
},
"4fVQDXM5F1okvt7nk51WefH8319j8XQo5H7PW3jr3XRE": {
"balance": 18002.34699528,
"percentage": 0.0024406121097535374
},
"431xet9CSscJ4fuDDPchTotNpMxu6xTUC4zku8YzkEjW": {
"balance": 17587.10870728,
"percentage": 0.0023843174724825283
},
"Cg4yZqxubkJRHV4SqLZ2qTLqvfaEaoqxHsGT55RQPa1m": {
"balance": 15083.515028,
"percentage": 0.0020449005590570052
}
}
},
"lastEventData": {
"tokenPrice": {
"mintId": "BjQxXBh6Pb8xDcSbgMuQdDDBNWoMVgvKrcVApmr9pump",
"userId": "a2DnvESKyWintb12mP5aD3UfKxTTiLPUhJjSxsNq531",
"price": 2.86178146146e-7,
"solAmount": 0.001370279,
"tokenAmount": 478.271054,
"userTokenPostAmount": 23597.914976,
"virtualBaseReserves": 335383935.434216,
"virtualQuoteReserves": 95.97955289,
"txSignature": "5i1jApVZs1Ei7t2sw1rh5nWcUSaFehGeRzrbsuBQnLpDGeEUGrkLXn9Vv4E6CvgwRhWbgH9Zg4k8c5XreWphVj1a",
"timestamp": 1751978287209,
"localTime": 1751978287137,
"uuid": 330134795016450000,
"programId": null,
"flinkTime": 1751978287212,
"buy": true
}
}
}Wallet Stats Message
{
"userId": "56S29mZ3wqvw8hATuUUFqKhGcSGYFASRRFNT38W8q7G3",
"walletPnlData": {
"userId": "56S29mZ3wqvw8hATuUUFqKhGcSGYFASRRFNT38W8q7G3",
"totalRealizedPnl": 0.6895861411517962,
"totalUnrealizedPnl": 0,
"totalPnl": 0.6895861411517962,
"totalTrades": 7,
"profitableTrades": 2,
"winRate": 28.57142857142857,
"lastTransactionTimestamp": 1751349977644,
"positions": {
"EjAJNaF3dqCapLRNoLErihxYX4mJQmWBUvHgBB3vpump": {
"mintId": "EjAJNaF3dqCapLRNoLErihxYX4mJQmWBUvHgBB3vpump",
"totalTokens": 5318392.835824,
"averageEntryPrice": 6.0097031482e-8,
"realizedPnl": 0,
"unrealizedPnl": 0,
"firstEntryTimestamp": 1751349946277,
"lastTransactionTimestamp": 1751349946277,
"lastTxSignature": "4dNziCaRcgmm5FBCxYJwSArMUdVw1zdTvn1AQZKjfA4hVRy25DcxUjo1TEVAfhSHEt36HG8bJMHa1fQXqs37J7nq",
"currentPrice": 6.0097031482e-8,
"operationCount": 1,
"totalTradingVolume": 0.31961962168815816,
"tradingVolumePercentage": 15.417540720956602
},
"9Xr61vGw9PGwjyqLyR6Tc57GzVeYLEfDRkFvm4Kxpump": {
"mintId": "9Xr61vGw9PGwjyqLyR6Tc57GzVeYLEfDRkFvm4Kxpump",
"totalTokens": 5323114.194414,
"averageEntryPrice": 5.9000663217e-8,
"realizedPnl": 0,
"unrealizedPnl": 0,
"firstEntryTimestamp": 1751349947022,
"lastTransactionTimestamp": 1751349947022,
"lastTxSignature": "5aofnrrjZC4fF7ukMzrHGXYTKLpDUDtS4cVWtqyh2vyncs5ZfE38xqBUTwaFA78Tm8YTKzLjqu4WsCaimnjDA54T",
"currentPrice": 5.9000663217e-8,
"operationCount": 1,
"totalTradingVolume": 0.3140672678502527,
"tradingVolumePercentage": 15.149710977147606
},
"9ZxXUT7dgrMsKg5ZQBaABMr3cJfgQ5evduV9CC3Dpump": {
"mintId": "9ZxXUT7dgrMsKg5ZQBaABMr3cJfgQ5evduV9CC3Dpump",
"totalTokens": 5322882.805041,
"averageEntryPrice": 5.9063671599e-8,
"realizedPnl": 0,
"unrealizedPnl": 0,
"firstEntryTimestamp": 1751349945598,
"lastTransactionTimestamp": 1751349945598,
"lastTxSignature": "29qnPYTmPTCLYroc1t3gpj2AChhRGyJk3BgypKxCa4r3oRaeoDfzvdWdc96VfFSXZpUJYtWn1P3zjyY6DSvZENxu",
"currentPrice": 5.9063671599e-8,
"operationCount": 1,
"totalTradingVolume": 0.31438900195690556,
"tradingVolumePercentage": 15.16523051460417
},
"14cKJUKv9FxxymYrC2o3xAp5LGUWx29C5p6abFZtpump": {
"mintId": "14cKJUKv9FxxymYrC2o3xAp5LGUWx29C5p6abFZtpump",
"totalTokens": 2701917.17893,
"averageEntryPrice": 5.4199509483e-8,
"realizedPnl": 0,
"unrealizedPnl": 0,
"firstEntryTimestamp": 1751349947022,
"lastTransactionTimestamp": 1751349947022,
"lastTxSignature": "2X1cXbXENWWfCJpg8edYjroo8hcyPtqZxLn9Q7jBBMzEVbUHcnwLxCDDrDS3e2ENLBSitpzB64asbAWTrAmKHb2h",
"currentPrice": 5.4199509483e-8,
"operationCount": 1,
"totalTradingVolume": 0.14644258576169714,
"tradingVolumePercentage": 7.063973473649836
},
"3HD7D5jGxhMbAUA5Tb8xSP32yeyMbsxATwbSVAPLpump": {
"mintId": "3HD7D5jGxhMbAUA5Tb8xSP32yeyMbsxATwbSVAPLpump",
"totalTokens": 5323439.645358,
"averageEntryPrice": 5.4285616631e-8,
"realizedPnl": 0,
"unrealizedPnl": 0,
"firstEntryTimestamp": 1751349945432,
"lastTransactionTimestamp": 1751349945432,
"lastTxSignature": "2AjLTpRGbqnis5RnH754hrvZ8BFQbNd3myCjPZSM3rrWPHwnerDzzWUKHpRak9Y76rEonyjH1oQMjrDMcTeWC8iW",
"currentPrice": 5.4285616631e-8,
"operationCount": 1,
"totalTradingVolume": 0.28898620374617096,
"tradingVolumePercentage": 13.93987184052889
},
"eWiWDJ6WES16tD51nmtBHd69Q2rjSgQmCgJAdh7pump": {
"mintId": "eWiWDJ6WES16tD51nmtBHd69Q2rjSgQmCgJAdh7pump",
"totalTokens": 0,
"averageEntryPrice": 0,
"realizedPnl": 0.23208689085124037,
"unrealizedPnl": 0,
"firstEntryTimestamp": 0,
"lastTransactionTimestamp": 1751349977644,
"lastTxSignature": "5bMi1jtpKDeVvUCB6p6zTGGpqjBvMpmghxdobXqheZKXhSiue8mVN35fxYoEFFvowQMgS5NCQX7va6G6Lory8bY4",
"currentPrice": 5.0036170262e-8,
"operationCount": 1,
"totalTradingVolume": 0.23208689085124037,
"tradingVolumePercentage": 11.195210956073105
},
"3nroLamcT6haFEQrVwTYXzLi6emBvRgzF8fy13VRpump": {
"mintId": "3nroLamcT6haFEQrVwTYXzLi6emBvRgzF8fy13VRpump",
"totalTokens": 0,
"averageEntryPrice": 0,
"realizedPnl": 0.4574992503005558,
"unrealizedPnl": 0,
"firstEntryTimestamp": 0,
"lastTransactionTimestamp": 1751349947079,
"lastTxSignature": "3Jc2ya2Gq8ot5whYf4MCAGqpGUyp7C396kRcwCfQHrGGWpYLG6JDLteFV6EChNnbS8j2fbMLexR9htdRd6PXnnkB",
"currentPrice": 4.5444036358e-7,
"operationCount": 1,
"totalTradingVolume": 0.4574992503005558,
"tradingVolumePercentage": 22.068461517039797
}
}
}
}Token Snapshot Message
{
"mintId": "EncrbDuNV9AK8PPek9JApDWiG4R6LdyJ8xrVxA5Npump",
"windowStart": 1752490320000,
"windowEnd": 1752490380000,
"openPrice": 2.78566362451e-7,
"highPrice": 2.83444475054e-7,
"lowPrice": 2.5590998494e-7,
"closePrice": 2.72434596151e-7,
"totalVolume": 10.751337617,
"buyVolume": 4.1581366530000015,
"sellVolume": 6.593200963999998,
"totalTxCount": 33,
"buyTxCount": 18,
"sellTxCount": 15,
"buySellCountRatio": 1.2,
"buyCountPercentage": 54.54545454545455,
"sellCountPercentage": 45.45454545454545,
"uniqueBuyers": [
"4uiFWb1p65YCn8rhnaj9kmbnDxF4PBesgk5RVomB4Qgp",
"13iai3A65vKVaYHXXmWscVfwH9mcbUu41ag2EqhieYXo",
"jT8sgqcTAiB2VFNE5nmx3dFhijemb26PCNs6AaZzXoo",
"EYALjTrFsLoziaLzyt7DbXVumU5kdeDADYLD9CoG5Ytu",
"EqJsE1FzKmwEXskGbpgm3jmRWaMXaJwiUmVCXtmFPraJ",
"5sFjyuhuCDrEtguZ4FjTEDM5kb1FRdEuecC582uXkiSz",
"2rrESvZVT6wr2i9cYrdKNxsugg2hNQKcpVazSXCNQdDd",
"CYR45pV5K3T5aZM4ENidKXeQEJghAV2ar7CoXm2xbrj2",
"6kYZJ1Q1hro7hRqVM13Tgiay9XNgZ46CLeJb7oY26Bir",
"CxZogxR34AW8wKTpDpowchH8VqrN3cFcXMPkXdu7B2pf",
"AP88cKH1p4rQLwWQYor8b7fyJpwde5VDEoxTiKQ4vkWi",
"8Qzs8NYERcEUdLo6TiiHizo32W2V3TG2V3EJFYXqZKEe",
"5vqSaurVoUqLvnMV5bHcwvQqiradHDQnKkmhjAKhHsru",
"49wqHFkLibERmoh3mzKcSFpQXjP95VxQPTx9EGcbU1Su",
"3kZJTCLWYsrt7NTWRgy2xTXVDmgGMUkF3Ve1dYuRjUwX",
"BV3kNdTo5eX8ZM1P1H6h3LbC4Av4uzE3ciZ6fBYwkkZE"
],
"uniqueSellers": [
"8WnAwSSYgm1k3dd6EzyYpWbiVZ5wRk593yDNbEZgeRF9",
"CnmgL6FS7kG1i7HvkZhYKviE7mM4YX3vnmnpdJRW3aUT",
"3g4VRWUSR6yeaEeMddofh4ZWX68hfxezFZfStmiQhqjv",
"3c2KsT3A5cxfd3p6akBnm8FNhK22mPm53u83sXWEchqD",
"HP4LrjWb8kzKm8P14U4xQPJMKAGjL6RdQAEPtjS42HGK",
"Hu2EJQypQKT9nHKeB5SWKx3rGbtb7M3CWSAvfowUFyqW",
"4HhSEYbStpDh8gFDvEZ2uCvGzvRGJvJY8WUWZQ6H5gW9",
"GHujjejBVk5HzxN6baN9tquSnyD4pvBWnopyhQNfvCNA",
"9A4WgdRpGL6B9T8rrDyhyCKzAWkWtQHW2rtdQRdjkcHm",
"HsceoaYzukrSKyhgLvvPKofxJAjWDDhvPWvrj6wQnCU5",
"BXmRkVKx8eXhLTYU493c4bWAcQAted9ZpcfmWXjhTjav",
"6YgqoPjAGANxa1HRmARWcx3r6pbzm6P39QqNqqgPLZQp",
"5veqSEw2FeP751qbPdsbYoNV4G1NxehzLygJwrMPPwLn",
"BW5Ja7hnEzNV34p8hNQZdgFGNiMJj9TMKF2wZsMFnrEq"
],
"uniqueBuyerCount": 16,
"uniqueSellerCount": 14,
"windowLabel": "1m",
"totalVolumeQuote": 10.751337617,
"buyVolumeQuote": 4.1581366530000015,
"sellVolumeQuote": 6.593200963999998,
"buyVolumePercentage": 38.67552858190558,
"sellVolumePercentage": 61.32447141809442,
"openTxSignature": "5vHxbvMzhVdw4R3Aoia2NrauJf4E1pxupjgngrpqPbBjJnrrSug2ChG3nccgVqU59V9YJ6CFnXuGkDjpSUnqMQUn",
"closeTxSignature": "5PHf73chcXHTQZJU51HdhKvkjdPyFtVcAYMiVGCNGmbGETWJc8CpQPCGsaZh2gLDbEFFuDL5FtcTSUjrL5XJLW3s",
"windowDurationMillis": 60000
}subscription
Confirmation of successful subscription to transaction stream.
{
"type":"subscription",
"status":"success"
}Last updated