One call returns what a card really trades for across 30 marketplaces — sold comps region by region, the cross-market difference net of fees, grade EV and live population. Each figure labelled by basis, each with its own timestamp. Create a key, make the call, ship.
$ curl https://hoshino.com/v1/comps/swsh4-215 \ -H "Authorization: Bearer hsh_live_…" { "card": "Pikachu VMAX", "markets": { "JP": { "basis":"sold", "price":268.40 }, "US": { "basis":"sold", "price":372.00 }, "EU": { "basis":"sold", "price":331.10 } }, "as_of": "2026-07-30T13:52Z" }
No sandbox form, no sales call for self-serve. If you can use the app, you can call the API.
The Data API is self-serve from $99/mo. Open Data API keys in the app and generate one. Keys carry the hsh_live_ prefix and are shown once — store it safely.
Send a standard request to hoshino.com/v1 with your key in the Authorization header. Every response is JSON — cards, per-region price, cross-market differences, grade EV and population.
Self-serve covers 50,000 calls/mo. Higher volume and the right to redistribute prices move to a custom commercial license ($500–5,000). Usage is live in the dashboard.
Everything the app shows you, addressable by card. Base URL https://hoshino.com/v1.
| Method | Endpoint | Returns |
|---|---|---|
| GET | /v1/cards?q={query} | Resolve any name, set or number to one stable card ID — set, rarity, images, variants. The anchor every other call prices against. |
| GET | /v1/comps/{cardId} | What the card trades for, region by region — sold comps for the US and Japan, market price for Europe, live market data for wider Asia. Each figure labelled by basis with its own timestamp. |
| GET | /v1/arbitrage/{cardId} | The cross-border engine — the like-for-like price difference between the lowest and highest market for a card, net of marketplace fees, shipping and live FX. Descriptive, not a projected return. |
| GET | /v1/pop/{cardId} | Grade EV and population — modeled value across PSA, CGC, BGS and SGC, from grade-tier prices, live population data and current fees. |
All responses are JSON. Every figure is labelled by basis — sold comp, daily market price, or live ask — and carries its own last-updated timestamp. We never pass an asking price off as a sale.
Ask for the cross-market difference on a card — get back every market, the lowest and highest, and the difference left after every cost.
curl https://hoshino.com/v1/arbitrage/swsh4-215 \ -H "Authorization: Bearer hsh_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",
"markets": {
"JP": { "source":"Mercari", "basis":"sold", "price":268.40, "sales":41 },
"US": { "source":"eBay", "basis":"sold", "price":372.00, "sales":63 },
"EU": { "source":"Cardmarket", "basis":"sold", "price":331.10, "sales":28 },
"SG": { "source":"Carousell", "basis":"ask", "price":322.00, "listings":18 }
},
"lowest_market": { "region":"JP", "source":"Mercari", "price":268.40 },
"highest_market": { "region":"US", "source":"eBay", "price":372.00 },
"gross_difference": 103.60,
"costs": { "marketplace_fee":48.36, "shipping":14.00, "fx_spread":3.20 },
"net_difference": 38.04
}
The gross price difference reads $103.60. After the marketplace fee, shipping and the JPY→USD spread, the like-for-like difference net of costs is $38.04 — a descriptive market figure, labelled by basis. Hoshino returns the data; it never promises an outcome.
Bearer-token auth over HTTPS. Limits scale with your plan and never turn into a surprise bill.
Authenticate every request with your secret key as a bearer token:
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.
| Plan | Included | Rate |
|---|---|---|
| Developer | 50,000 calls/mo | 600 / min |
| Commercial license | Custom volume | Custom |
Self-serve from $99/mo issues a programmatic key with 50,000 calls a month. Redistribution — the right to publish Hoshino prices in your own product — and higher volume move to a custom commercial license, $500–5,000/mo.
Exceed the limit and the API returns 429 with a Retry-After header — never a silent overage charge.
If your product needs to know what a card is worth anywhere on earth, that's one call.
Collection trackers, deal feeds, Discord bots and scanners that want the real global price behind every card, without building the pipeline.
Price your own listings against the world, flag under- and over-priced inventory, and give sellers a benchmark that isn't just one country's.
Value a collection or a book of cards to real, sourced market prices — with the basis and timestamp behind every figure, for numbers you can defend.
Hoshino routes buyers to the source marketplace. If you send the traffic, the affiliate layer makes sure you're credited.
Buy-links route through official partner programs — the eBay Partner Network and TCGplayer — so referrals are tracked cleanly and credited to you.
Enable the affiliate program with your API key, tag your outbound links, and track referrals from the same dashboard. Open on every plan — no key required.
The same cross-market prices, differences and grade EV the app runs on — now under your own roof. Self-serve from $99/mo.