Market data API
Public, read-only JSON feeds of HiMarket's aggregated card prices — lowest ask, highest bid and daily history for Magic: The Gathering and Riftbound in Hong Kong.
What it is
HiMarket publishes its aggregated market prices as two public JSON endpoints, for price trackers, researchers and anyone who wants to see what cards trade for in Hong Kong. No account or API key is needed. Everything here is an aggregate the marketplace already shows on its pages — there is no buyer, seller, account or order information.
This is the interface our Terms refer to when they say automated access is allowed only via interfaces we expressly provide. Please read Terms of use below before integrating. Scraping card pages or other routes is not permitted.
Market snapshot
GET https://www.himarket.hk/api/public/v1/market?game=riftbound
One row per printing × language × finish × condition combination that currently has a live ask or a standing bid. game is required: riftbound or mtg.
| Field | Meaning |
|---|---|
printingId | HiMarket printing id: set code + collector number (ogn-039), prefixed rb- for Riftbound (rb-ogn-039). |
cardName | Canonical English card name. |
set, collectorNumber | The same identity, split. |
language | Language code: en, zht (Traditional Chinese), zhs (Simplified Chinese), ja, ko, fr, de, es, pt, it, ru, … |
finish | nonfoil, foil or etched. |
condition | NM (Near Mint), SP (Slightly Played) or MP (Moderately Played). |
lowestAskHkd | Lowest live asking price in HK$ for this combination, or null if nothing is for sale. |
highestBidHkd | Highest standing buy offer in HK$, or null if nobody is bidding. |
updatedAt | When this printing's aggregate was last recomputed (ISO 8601). |
url | The HiMarket card page for this printing — use it for your link-back. |
preorder | true while the set is an active preorder set (asks are for pre-release stock). |
The envelope carries version, game, currency (HKD), snapshotAt (when the snapshot behind the rows was last refreshed) and generatedAt. Responses are cached for 15 minutes.
Price history
GET https://www.himarket.hk/api/public/v1/history?printingId=rb-ogn-039
Daily history for one printing. Optional finish=nonfoil|foil|etched narrows to one finish (default: every finish the printing exists in) and days sets the lookback window (default 365, maximum 5 years). Unknown printings return 404.
| Series | Points |
|---|---|
reference | { date, usd, hkd } — the English-market reference price (TCGplayer via Scryfall for MTG; TCGplayer for Riftbound). HK$ at the USD peg. |
market | { date, lowestAskHkd, highestBidHkd } — HiMarket's own lowest ask and highest bid, Near-Mint equivalent. |
trades | { date, priceHkd, nmEquivalentHkd, condition, language, finish } — anonymised completed sales on HiMarket. Price and date only; never who bought or sold. |
Every series is delta-encoded: a point exists only where the value changed. Step between points; do not interpolate, and do not read a gap as missing data. basis is nmEquivalent — market and trade prices are divided by the condition factor so played copies compare with mint ones. Responses are cached for 30 minutes.
Identifiers
printingIdis stable and the key to join both endpoints. Card pages resolve the same id in their URL slug.- Language codes follow Scryfall's scheme (
zht= Traditional Chinese,zhs= Simplified Chinese). - Riftbound reference prices are English-market; HiMarket's Chinese-language Riftbound listings typically trade well below them.
Terms of use
Using this data is free, on these conditions
- Cadence: fetch the market snapshot at most every 15 minutes per game, and history at most once a day per printing. Both endpoints are cached, so faster polling gains nothing. Do not crawl card pages or any other route.
- Attribution: label the data as HiMarket (Hong Kong) wherever it is shown, and link back to the card page using the
urlfield. You may append your ownutm_sourceparameter. - Display and aggregation only: you may show, chart and aggregate the data in your product. Do not redistribute the raw feed or offer it as a dataset.
- Represent it accurately: Hong Kong is a small market and many prices come from a single seller. Present it as HiMarket data, not as "the Hong Kong market price".
- Not included: listing counts, quantities and sales volume are not published. Image URLs are not part of this interface.
- Revocable: we may change limits or withdraw access with notice by email.
Within a version, changes are additive only: new fields may appear, existing ones keep their meaning. A breaking change ships as a new version path (/api/public/v2/…) and the old one stays up for a transition period.
Questions, integration notes, or a request for something not covered here: hello@himarket.hk. If you run an agent rather than a scheduled job, the Agent MCP may suit you better.