Skip to main content
GET
Get a pack's pool

Authorizations

Authorization
string
header
required

Your API key (cb_live_…), sent as a bearer token, with the scope nft:orders. Keep it on your servers: never in a browser, app or wallet. Use a separate key per environment. A request from a country on our sanctions list gets a 403 with Access denied, whether or not it has a valid key. See Authentication and keys.

Scopes

nft:orders

Query Parameters

pack_type
string
required

A pack_type from List packs.

Required string length: 1 - 100
category
enum<string>
default:pokemon

The catalog. goods packs hold streetwear and jewelry. Raw singles have no category of their own: they come out of other categories' packs.

Available options:
pokemon,
onepiece,
sports,
riftbound,
watches,
goods
odds
enum<string>

One the pack sells. Default the pack's default_odds. The odds a pack is opened at, as in our app's picker. Standard, Hot and Chill share one value-band ladder and differ only in the chance of each band; Classic is the pack's own bands and chances. A pack that sells only its own odds sells just classic. Odds.

Available options:
standard,
hot,
chill,
classic

Response

The pool at those odds.

ModePackPool for a pack that sells the odds choice, ClassicPackPool (odds: "classic", with bucket_id bands) for a pack that sells only its own odds.

pack_type
string
required
name
string
required
category
enum<string>
default:pokemon
required

goods packs hold streetwear and jewelry. Raw singles have no category of their own: they come out of other categories' packs.

Available options:
pokemon,
onepiece,
sports,
riftbound,
watches,
goods
price
number
required
odds
enum<string>
required

The odds a pack is opened at, as in our app's picker. Standard, Hot and Chill share one value-band ladder and differ only in the chance of each band; Classic is the pack's own bands and chances. A pack that sells only its own odds sells just classic. Odds.

Available options:
standard,
hot,
chill,
classic
label
string
required
tagline
string
required
available
boolean
required

Whether these odds are selling right now.

fresh_buyback_rate
number
required

The sell-back rate in the fresh window, as a fraction (1 = 100%).

consolation_probability
number | null
required

The chance of the pack's consolation prize, where it has one.

bands
object[]
required
odds_choices
object[]
required
total_cards
integer
required
cards
object[]
required

Every item a pull can produce at these odds, highest value first.