COMEX Live APIcomexlive.org ↗
Access real-time COMEX gold, silver, platinum, and 15+ commodity prices plus news articles via the COMEX Live API. Daily high/low, last trade, and more.
What is the COMEX Live API?
The COMEX Live API exposes 6 endpoints covering real-time futures prices for 15+ commodities — including gold, silver, platinum, crude oil, and agricultural contracts — alongside full-text news articles. The get_all_comex_prices endpoint returns a dashboard-level snapshot of every tracked instrument in a single call, while dedicated endpoints like get_gold_price and get_silver_price return per-commodity fields including last_trade, change_usd, change_percent, and last_trade_timestamp.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/6d3646e0-7998-4f3a-a580-06eb68d88703/get_gold_price' \ -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 comexlive-org-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.
"""Walkthrough: COMEX Live API — real-time commodity prices and market news."""
from parse_apis.comex_live_api import ComexLive, ArticleNotFound
client = ComexLive()
# Fetch gold spot price — single typed resource, no iteration needed.
gold = client.commodityprices.gold()
print(f"Gold: ${gold.last_trade} ({gold.change_percent})")
# Fetch silver and platinum for comparison.
silver = client.commodityprices.silver()
print(f"Silver: ${silver.last_trade} ({silver.change_percent})")
platinum = client.commodityprices.platinum()
print(f"Platinum: ${platinum.last_trade} ({platinum.change_percent})")
# Dashboard — all 15 commodities in one call.
dashboard = client.dashboards.get()
print(f"Dashboard timestamp: {dashboard.timestamp}, commodities: {len(dashboard.prices)}")
for price in dashboard.prices[:3]:
print(f" {price.symbol}: {price.last} change={price.change}")
# Latest news articles — bounded iteration.
article_summary = client.articlesummaries.list(limit=3).first()
if article_summary:
print(f"Top article: {article_summary.title} ({article_summary.date})")
# Drill into full article content via the summary's navigation op.
try:
full = article_summary.details()
print(f" Body preview: {full.body[:120]}...")
print(f" Category: {full.category}, Tags: {len(full.tags)}")
except ArticleNotFound as exc:
print(f"Article gone: {exc}")
print("exercised: commodityprices.gold / silver / platinum / dashboards.get / articlesummaries.list / details")
Returns the current COMEX Gold spot price with daily high, low, open, last trade price, and USD/percentage change. Data refreshes during market hours; outside trading hours, the last available values persist.
No input parameters required.
{
"type": "object",
"fields": {
"low": "string, daily low price",
"high": "string, daily high price",
"open": "string, opening price",
"commodity": "string, commodity name (Gold)",
"timestamp": "string, data timestamp in human-readable format",
"change_usd": "string, price change in USD",
"last_trade": "string, current price with commas",
"change_percent": "string, percentage change with % suffix",
"last_trade_timestamp": "string, time of last trade"
}
}About the COMEX Live API
Commodity Price Endpoints
Three commodity-specific endpoints — get_gold_price, get_silver_price, and get_platinum_price — each return the same nine-field structure: last_trade, open, high, low, change_usd, change_percent, commodity, timestamp, and last_trade_timestamp. All price fields are returned as strings. The timestamp reflects when the data snapshot was captured, while last_trade_timestamp is the time of the most recent recorded trade on that instrument.
Full Dashboard Snapshot
The get_all_comex_prices endpoint returns a prices array covering 15 instruments: Gold, Silver, Platinum, Palladium, Copper, Aluminum, Crude Oil, Brent Oil, Natural Gas, Gasoline, Heating Oil, Coffee, Sugar, Wheat, and Corn. Each element in the array includes symbol, last, change, change_percent, close, high, low, and last_trade fields, plus a top-level timestamp for the entire dashboard snapshot. This is the most efficient call when you need cross-commodity coverage in a single request.
News Endpoints
Two endpoints handle commodity news from comexlive.org. get_latest_news returns up to 10 recent article summaries, each with title, url, excerpt, category, tags, and date. To retrieve the complete text of a specific article, pass its full URL to get_news_article, which returns the body, title, date (in YYYY-MM-DD format extracted from the URL path), category, and tags array. The url parameter for get_news_article must be a valid comexlive.org article URL.
The COMEX Live API is a managed, monitored endpoint for comexlive.org — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when comexlive.org 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 comexlive.org 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?+
- Display a live gold price ticker using
last_tradeandchange_percentfromget_gold_price. - Build a multi-commodity price dashboard by iterating the
pricesarray fromget_all_comex_prices. - Alert users when
change_usdon silver crosses a defined threshold usingget_silver_price. - Aggregate commodity news headlines and excerpts from
get_latest_newsinto a market briefing feed. - Archive full article content for NLP or sentiment analysis using
get_news_articlewith article URLs fromget_latest_news. - Track daily open-to-current divergence for platinum by comparing
openandlast_tradefields fromget_platinum_price. - Monitor agricultural commodity moves (Wheat, Corn, Sugar) via the
get_all_comex_pricesdashboard snapshot.
| 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 comexlive.org have an official developer API?+
What distinguishes `timestamp` from `last_trade_timestamp` in price responses?+
timestamp reflects when the data snapshot was recorded for the response. last_trade_timestamp is the time of the most recent individual trade captured for that commodity. During low-liquidity periods these two values may differ noticeably.Does the API cover historical price data or only the current session?+
last_trade, open, high, low, change_usd, and change_percent for the active trading day. Historical OHLC series or time-series data are not currently included. You can fork this API on Parse and revise it to add a historical data endpoint if comexlive.org exposes that coverage.Can I filter `get_latest_news` by category or tag?+
get_latest_news; it returns up to 10 recent articles as a flat list. Each article object includes category and tags fields you can filter client-side. You can fork this API on Parse and revise it to add category or tag filtering as an input parameter.Are Palladium or Copper available as standalone price endpoints like Gold and Silver?+
prices array from get_all_comex_prices but do not have dedicated single-commodity endpoints equivalent to get_gold_price. The available dedicated endpoints cover Gold, Silver, and Platinum only. You can fork this API on Parse and revise it to add standalone endpoints for Palladium, Copper, or any other instrument in the dashboard.