twitcheasy-twitch-bottwitch-authtwitch-auth-tmitwitch-chat-clienttwitch-eventsubtwitch-pubsub-clienttwitch-webhooks
Welcome

HelixBitsApi

The Helix API methods that deal with bits.

Overview

Can be accessed using client.helix.bits on an ApiClient instance.

Example

const api = new ApiClient(new StaticAuthProvider(clientId, accessToken));
const leaderboard = await api.helix.bits.getLeaderboard({ period: 'day' });

Methods

getCheermotes(broadcaster)

async

Retrieves all available cheermotes.

Parameter Type Required Default Description
broadcaster UserIdResolvable none

The broadcaster to include custom cheermotes of.

If not given, only retrieves global cheermotes.

Return type: HelixCheermoteList

getLeaderboard(params)

async

Retrieves a bits leaderboard of your channel.

Parameter Type Required Default Description
params HelixBitsLeaderboardQuery {} see below
params.contextUserId string none

The user ID to show.

The leaderboard will be guaranteed to include this user and then have more users before and after that user.

params.count number none

The number of leaderboard entries you want to retrieve.

params.period
HelixBitsLeaderboardPeriod

The possible time periods for a bits leaderboard.

Aliased type: "day" | "week" | "month" | "year" | "all"

none

The time period from which bits should count towards the leaderboard.

The leaderboards reset with the start of a new period, e.g. the week leaderboards reset every Monday midnight PST.

params.startDate Date none

The time to retrieve the bits leaderboard for.

Return type: HelixBitsLeaderboard