Docs/API Reference/Lotteries and Claims

Lotteries and Claims

List lotteries, enter with tokens, inspect entries, and submit claims.

Balance

const balance = await client.getTokenBalance();

List lotteries

const { lotteries } = await client.getLotteries({ filter: "active" });

Filters typically include active and completed (previous rewards).

Enter

import { createIdempotencyKey } from "@adquest/sdk";

const purchase = await client.enterLottery(lotteryId, {
  entryCount: 1,
  idempotencyKey: createIdempotencyKey(),
});

Always send a unique idempotency key so retries do not double-charge tokens.

My entries and results

const entries = await client.getMyLotteryEntries(lotteryId);
const results = await client.getLotteryResults(lotteryId);

Claims

const claim = await client.submitClaim({
  /* claim payload fields from lottery win */
});

AdQuestWidget exposes claim UI when a reward is claimable; listen with onClaim.