Skip to main content
Customers choose the odds they buy at, exactly as in our app. The odds shown are the odds the pack is opened with.
  • Standard, Hot and Chill share one band ladder and differ only in the chance of each band.
  • A pack that sells only its own odds lists just classic.
  • On packs that offer the choice, every one of them sells back at 100% for the first 5 minutes after the NFT is confirmed (Sell-back); the pool’s fresh_buyback_rate gives the exact rate for each.

Which odds a pack sells

GET /catalog/packs lists, for each pack:
  • odds: the odds choices the pack sells, in the order our app’s picker shows them;
  • default_odds: the one an order gets when it names none (Standard wherever it is sold).
Whether a particular odds choice is selling right now is on the pool endpoint.

Show the odds before the customer buys

GET /catalog/packs/pool returns what one pack can pull at one odds choice: the value bands with their chances, whether those odds are selling right now, and every item a pull can produce. This is the same information as the odds panel in our app, so show it to your customers before they buy.
  • bands[].odds is the chance (0 to 1) of a pull landing in that band at these odds, and cards how many items sit in it. A band at 0 can’t pull at these odds.
  • available says whether these odds are selling right now; odds_choices gives the same for every choice the pack sells.
  • consolation_probability is the chance of the pack’s consolation prize, where it has one, else null.
  • fresh_buyback_rate is the sell-back rate in the fresh window, as a fraction (1 = 100%).

Ordering at an odds choice

Pass odds to POST /orders. The order’s odds is the odds the pack is opened at.
  • An odds value the pack doesn’t sell is 400 BAD_ODDS, with odds listing the choices it sells.
  • Odds that aren’t selling right now are 409 ODDS_UNAVAILABLE, and nothing is created: try another choice or later.
  • If those odds stop selling before the payment settles, the pack isn’t opened at other odds: the order goes to refund_due and the customer is refunded.