USA Coin Book APIusacoinbook.com ↗
Access US coin categories, series data, melt values, grade-based prices, and marketplace listings from usacoinbook.com via a structured JSON API.
What is the USA Coin Book API?
The USA Coin Book API exposes 7 endpoints covering US coin reference data and marketplace listings from usacoinbook.com. Starting with list_coin_categories, you can navigate the full denomination and series hierarchy, drill into individual series with get_coin_series_page to retrieve mintage figures and grade-based values, and pull active marketplace listings with search_coins. Melt values and spot prices for all major US coin metal types are available through a dedicated endpoint.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/4bd6afb6-4ee0-4454-bb1d-d4cb11d8899d/list_coin_categories' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace usacoinbook-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.usa_coin_book_api import USACoinBook, Denomination, Series, CoinSummary, Listing, Melt, Ranking
client = USACoinBook()
# List all coin denominations and browse series
for denomination in client.denominations.list():
print(denomination.name, denomination.count)
for series in denomination.series:
print(series.name, series.count, series.url)
break
break
# Get coins in a series by constructing from URL
wheat_cents = client.series(url="https://www.usacoinbook.com/coins/small-cents/lincoln-wheat-cent/")
page = wheat_cents.coins()
print(page.title, page.description)
for coin_summary in page.coins:
print(coin_summary.year, coin_summary.mintage, coin_summary.url)
coin_detail = coin_summary.details()
print(coin_detail.name, coin_detail.image_obverse)
for grade, price in coin_detail.prices.items():
print(grade, price)
break
# Search marketplace listings
for listing in client.listings.search(query="morgan dollar"):
print(listing.title, listing.price)
detail = listing.details()
print(detail.title, detail.price)
break
# Get melt values for all US coins
for melt in client.denominations.melt_values():
print(melt.type_description, melt.melt_value, melt.weight)
break
# Get most valuable coins rankings
for ranking in client.denominations.most_valuable():
print(ranking.title)
for item in ranking.items:
print(item.coin, item.value)
break
break
Get structured list of all coin denominations and series from usacoinbook.com. Each denomination contains a name, coin count, URL, and nested series array. Series entries expose their URL for use with get_coin_series_page.
No input parameters required.
{
"type": "object",
"fields": {
"categories": "array of denomination objects with denomination, count, url, and series"
},
"sample": {
"data": {
"categories": [
{
"url": "https://www.usacoinbook.com/coins/half-cents/",
"count": 176,
"series": [
{
"url": "https://www.usacoinbook.com/coins/half-cents/liberty-cap/",
"name": "Liberty Cap",
"count": 2
}
],
"denomination": "Half Cents"
}
]
},
"status": "success"
}
}About the USA Coin Book API
Coin Reference Data
list_coin_categories returns the full denomination tree from usacoinbook.com — each entry includes a denomination name, coin count, and a nested series array with names and URLs. These series URLs feed directly into get_coin_series_page, which returns a coins array where each object carries the year, mintage, grade-specific values, and a link to the detail page. The series response also includes a specifications object (e.g. metal composition, diameter, weight) and a plain-text description.
Coin Detail and Valuation
get_coin_detail_page accepts a URL from get_coin_series_page coins[*].url and returns structured fields: name, prices (a grade-to-price map), information (mintage, designer, metal composition, diameter, weight), and obverse/reverse image URLs. Note that in some cases prices appear embedded in the information text rather than in the prices object. get_coin_melt_values returns a coins array covering all major US coin types with fields for metal content composition, weight, denomination, and computed melt value, plus a spot_prices object keyed by metal name.
Marketplace and Discovery
search_coins queries the usacoinbook.com marketplace and returns an array of listing objects — each with a title, price, URL, and seller info string. Passing a listing URL to get_listing_detail retrieves structured listing_specs (seller, shipping, return policy) alongside the full description and price. If a listing has been removed, the endpoint returns stale_input.
Most Valuable Coins
get_most_valuable_coins returns a lists array where each entry has a title and an items array of coin name and estimated value pairs. These lists are categorized (e.g. by series or era) and sorted by value, useful for quick reference on high-value US coins.
The USA Coin Book API is a managed, monitored endpoint for usacoinbook.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when usacoinbook.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official usacoinbook.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a coin collection tracker that pulls current grade-based values from
get_coin_series_pagefor a given series. - Calculate the melt floor for a batch of coins using metal composition and melt values from
get_coin_melt_values. - Monitor active marketplace listings for specific coins using
search_coinswith targeted queries like '1909 S VDB lincoln penny'. - Populate a coin catalog app with obverse and reverse images and technical specs from
get_coin_detail_page. - Identify high-value targets in a collection by cross-referencing holdings against the
get_most_valuable_coinslists. - Aggregate mintage data across a full denomination by iterating series URLs from
list_coin_categoriesintoget_coin_series_page. - Summarize marketplace listing terms — seller, shipping, and return policy — before directing buyers using
get_listing_detail.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does usacoinbook.com offer an official developer API?+
What does `get_coin_series_page` return, and what input does it need?+
get_coin_series_page takes a url parameter — a series page URL from list_coin_categories series[*].url — and returns a coins array with year, mintage, and grade-based value columns per coin, plus a specifications object and series description. If the URL does not point to a valid series page, the endpoint returns stale_input.Are auction results or historical sale prices available?+
search_coins and get_listing_detail, and grade-based reference values from coin series and detail pages, but does not expose historical auction records or realized prices. You can fork this API on Parse and revise it to add an endpoint targeting usacoinbook.com auction history pages if that data is present on the site.Can I retrieve spot prices for metals through this API?+
get_coin_melt_values includes a spot_prices object keyed by metal name alongside the melt value data. The field is noted as potentially empty if the prices are not parseable from the page at request time, so downstream code should handle an empty object gracefully.Does the API support pagination for marketplace search results?+
search_coins returns a single results array for a given query string with no page or offset parameter exposed. You can fork this API on Parse and revise it to add pagination support if usacoinbook.com's search supports multiple result pages.