Skip to main content
POST
/
streamers
Get custom list of streamers with flexible sorting
curl --request POST \
  --url https://api.livesuite.app/streamers \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "tokenAddresses": [
    "AxSMXaM3KeQ3a6HDfGizJaRnzGqrDHJg3uyZbwZUpump",
    "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
  ]
}
'
{
  "success": true,
  "data": [
    {
      "mintId": "<string>",
      "coinName": "<string>",
      "coinSymbol": "<string>",
      "currentViewers": 123,
      "tokenMarketCap": 123,
      "tokenPrice": 123,
      "isCurrentlyLive": true,
      "totalStreamingTime": 123,
      "chain": "<string>",
      "platform": "<string>"
    }
  ],
  "pagination": {
    "page": 123,
    "limit": 123,
    "total": 123,
    "totalPages": 123,
    "hasNext": true,
    "hasPrev": true
  },
  "timestamp": "2024-01-15T10:30:00.000Z"
}

Authorizations

​
x-api-key
string
header
required

API key for API authentication

Body

application/json
​
tokenAddresses
string[]
required

Array of token mint addresses to fetch

Required array length: 1 - 100 elements
Required string length: 32 - 44
Example:
[
  "AxSMXaM3KeQ3a6HDfGizJaRnzGqrDHJg3uyZbwZUpump",
  "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
]
​
sortBy
enum<string>
default:viewers

Field to sort by

Available options:
viewers,
time,
averageViewers,
marketCap
​
sortOrder
enum<string>
default:desc

Sort order

Available options:
asc,
desc
​
limit
integer
default:100

Number of results to return

Required range: 1 <= x <= 1000
​
page
integer
default:1

Page number for pagination

Required range: x >= 1
​
chain
enum<string>
default:solana

Blockchain chain (solana for PumpFun, base for Zora, all for aggregated data from both)

Available options:
solana,
base,
all
Example:

"solana"

​
platform
enum<string>
default:pumpfun

Platform (pumpfun for Solana, zora for Base, all for aggregated data from both)

Available options:
pumpfun,
zora,
all
Example:

"pumpfun"

Response

Custom list of streamers sorted by requested field

​
success
boolean
Example:

true

​
data
object[]

List of streamers sorted by requested field

​
pagination
object
​
timestamp
string<date-time>
Example:

"2024-01-15T10:30:00.000Z"