HoshinoBuild on the same data the app runs on
Real sold prices across 35+ marketplaces in 7 regions, the cross-border spread net of every fee, and grade-EV in dollars — all behind one clean REST API. Create a key, make a call, ship.
Three steps to your first call
No sandbox request form, no sales call. If you can use the app, you can use the API.
1 · Create an API key
The Data API is part of the Business + API plan ($199/mo). Sign in to the members app, open Data API keys, and generate a key. Keys carry the ce_live_ prefix and are shown once — store it somewhere safe.
2 · Call the endpoints
Send a standard HTTPS request to hoshino.com/v1 with your key in the Authorization header. Every response is JSON — cards, per-region sold medians, spreads and grade-EV.
3 · Scale by plan
API keys are issued on the Business + API plan. Your key's per-minute limit follows the plan on the account that owns it, so an upgrade applies on the next request and a downgrade keeps the key working at the lower rate. Usage is live in Data API keys.
Four calls cover the whole workflow
Everything the app shows you, addressable by card. Base URL https://hoshino.com/v1.
| Method | Endpoint | Returns |
|---|---|---|
| GET | /v1/cards?q={query} | Turn a name, set or number into the exact card ID — with set, rarity, images and variants — the anchor every other call prices against. |
| GET | /v1/comps/{cardId} | A card's real value in every region — recency-weighted sold medians for the US, Japan, Europe, China, Korea, Taiwan and SEA. Never asking prices. |
| GET | /v1/arbitrage/{cardId} | The money in the gap — best buy market versus best sell market, net of marketplace fees, shipping and live FX. |
| GET | /v1/pop/{cardId} | Should-I-grade EV — expected net profit across PSA, CGC, BGS and SGC, using real graded comps and 2026 fees. |
All responses are JSON. Prices are real completed sales, never asking prices, and every figure carries its own last-updated timestamp.
One call, the whole spread
Ask for the cross-border spread on a card and get back the buy side, the sell side, and the money left after every cost.
curl https://hoshino.com/v1/arbitrage/swsh4-215 \ -H "Authorization: Bearer ce_live_9f2c1a7b4e08d63f21c05a7e"
{
"card": {
"id": "swsh4-215",
"name": "Pikachu VMAX",
"set": "Vivid Voltage",
"language": "EN",
"condition": "NM"
},
"currency": "USD",
"as_of": "2026-07-30T13:52:04Z",
"medians": {
"JP": { "market": "Mercari", "sold": 268.40, "sales": 41 },
"US": { "market": "eBay", "sold": 372.00, "sales": 63 },
"EU": { "market": "Cardmarket", "sold": 331.10, "sales": 28 },
"CN": { "market": "Dewu", "sold": 289.75, "sales": 34 },
"KR": { "market": "Bunjang", "sold": 305.20, "sales": 12 }
},
"best_buy": { "region": "JP", "market": "Mercari", "price": 268.40 },
"best_sell": { "region": "US", "market": "eBay", "price": 372.00 },
"gross_gap": 103.60,
"costs": {
"marketplace_fee_pct": 13.0,
"marketplace_fee": 48.36,
"shipping": 14.00,
"fx_spread": 3.20
},
"net_gap": 38.04,
"roi_pct": 14.2,
"verdict": "BUY_JP_SELL_US"
}
The gross gap reads $103.60. After eBay's ~13% fee, shipping and the JPY→USD spread, the real number is $38.04 — a 14% return on a card you can source today. That net figure is the only one Hoshino ever surfaces.
Your key, your quota
Bearer-token auth over HTTPS. Limits scale with your plan and never turn into a surprise bill.
Authentication
Authenticate every request with your secret key as a bearer token:
Authorization: Bearer ce_live_…
All requests must be HTTPS. Keys are scoped to your account, can be rotated or revoked instantly, and never expire until you say so. Treat a key like a password — anyone holding it can spend your quota.
Rate limits by plan
| Plan | Rate limit | Best for |
|---|---|---|
| Free | 30 / min | Building and testing against live data. |
| Scout | 120 / min | Personal tools and single-store lookups. |
| Edge | 300 / min | Active repricing and portfolio automation. |
| Business + API | 1,200 / min | Full commercial data API, live feed and team seats. |
Exceed a limit and the API returns 429 with a Retry-After header — never a silent overage charge.
Keys and real-time usage live in the members app under Data API keys, on the Business + API plan. Generate, name, rotate and revoke keys there, and watch calls and remaining quota update live.
Earn on the buy-link
Every deal Hoshino surfaces points to a real listing. When your traffic buys, you share the commission.
Routed, not scraped
Buy-links route through official partner programs — the eBay Partner Network and TCGplayer — so purchases are tracked cleanly and credited to you. Hoshino sends buyers to the cheapest real market; the affiliate layer just makes sure you get paid when they act on it.
Join alongside your key
Enable the affiliate program alongside your API key, tag your outbound links, and track referrals and payouts from the same dashboard. The affiliate program itself is open on every plan — it does not need an API key. Ideal if you run a deal feed, a Discord, or a tool built on the Hoshino API.
Build on the world's sold prices
Start free to explore the data, upgrade to Business + API when you need keys, and make your first call in minutes.