Sourcing API

Pokémon, One Piece, Baseball, Basketball, Football.

const response = await fetch(process.env.LION_API_BASE_URL + "/sourcings", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.LION_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "name": "Pokémon sourcing",
    "active": true,
    "deadline": "2026-10-31T23:59:59Z",
    "target_quantity": 100,
    "common_conditions": {
      "languages": ["English", "Japanese"],
      "grade_min": 8, "grade_max": 10,
      "allow_qualified": false
    },
    "rules": [{
        "label": "Pokémon $50–$250",
        "categories": ["Pokemon"],
        "value_min": 50, "value_max": 250,
        "min_confidence": 3,
        "payout_pct": 90
    }]
  }),
});
if (!response.ok) throw new Error("Request failed: " + response.status);
const sourcing = await response.json();

API preview. Endpoints and keys are not yet public.
Dates use ISO 8601 in UTC: 2026-10-31T23:59:59Z.

Filter reference

Card identity

categories

Pokemon · OnePiece · Baseball · Basketball · Football

Values are case-sensitive; Pokémon is sent as Pokemon.

languages

["English", "Japanese"]

A language filter requires positive evidence. Unknown language does not match.

graders

["PSA", "BGS", "CGC", "SGC"]

Narrow to any subset of the four supported graders.

players

["Shohei Ohtani"]

Match a named player or character.

keywords / exclude_keywords

["Prizm"] / ["reprint"]

Include or exclude words in the card metadata.

year_min / year_max

2020 / 2026

Inclusive card release years, separate from sourcing dates.

Grade, confidence & value

grade_min / grade_max

8 / 10

Inclusive grades; half grades are supported.

grades

[8, 9, 10]

Exact grade choices in common_conditions; also respect any grade range.

allow_qualified

false

Exclude qualified grades. Both shared and bucket rules must allow them.

cert_number_min

70000000

Inclusive numeric certificate floor, not a collector number.

value_min / value_max

50 / 250

Inclusive Card Ladder market value in USD, not the purchase offer. 99 means $99.00.

min_confidence

3

Card Ladder confidence ≥3/5. Values 1–5 retain the service floor (currently 3). Only bucket value 0 accepts any confidence; an explicit shared floor still applies.

payout_pct / use_supplier_payout

90 / false

Offer percentage of CL value, or inherit the buyer default. A 0% payout is not buying.

Shared rules & exclusions

common_conditions

{ grade_min: 8, allow_qualified: false }

Shared requirements AND the bucket criteria must pass. Missing required facts do not qualify.

rules

[{ label, active, categories, value_min, value_max, … }]

Separate price or category buckets. label names a bucket; active switches it on or off.

default_payout_pct

90

Buyer-level payout inherited by rules that set use_supplier_payout: true.

exclusions

[{ categories, year_min, year_max, card_types, value_above }]

Every condition within an exclusion must match; any matching exclusion vetoes the buyer.

card_types / value_above

["rookie", "prospect"] / 100

Inside an exclusion: rookie OR prospect, and CL value strictly greater than $100.

Sourcing lifecycle · proposed API fields

name / target_quantity

"October Pokémon" / 100

A readable sourcing name and the number of cards to acquire.

deadline

"2026-10-31T23:59:59Z"

Required ISO 8601 UTC timestamp. The date picker uses the end of the selected UTC day.

starts_at

"2026-10-01T00:00:00Z"

Optional ISO 8601 UTC start time. Omit to start immediately.

active

true / false

Pause or resume new sourcing while retaining existing acquisitions.

sourced_quantity / target_quantity

72 / 100

Read fulfillment across sourcings; acquired cards are available per sourcing.

Sourcing dashboard

210 / 420 cards sourced1 / 5 buckets filled$26,330 acquired

Bucket	Account	Sourced	Deadline · UTC	Status
Pokémon · EN / JP	Atlas Collectibles	72 / 100	2026-10-31	Sourcing
One Piece · collection	Atlas Collectibles	60 / 60	2026-10-31	Filled
Baseball · modern	Atlas Collectibles	46 / 80	2026-11-15	Sourcing
Basketball · PSA 9+	Northstar Cards	0 / 80	2026-11-15	Paused
Football · premium	Northstar Cards	32 / 100	2026-11-30	Sourcing