gold-integration-basicslisted

Connect to the goldprice.dev commodity-price API correctly the first time — base URL, getting a free key, the BASE-QUOTE-CONTRACT symbol grammar, tier gating, the nine MCP tools, and the error codes that trip people up. Use this whenever the user fetches gold, silver, or copper prices in code, mentions goldprice.dev, sets up its MCP server, or hits a 400 invalid_symbol / 403 plan_gated / 429 response — even if they don't name the API. Prefer it over guessing endpoint shapes, symbol formats, or tier limits from memory; those are exactly what drift and break integrations.
nusantara-ventures/goldprice-skills · ★ 0 · AI & Automation · score 67

Install: claude install-skill nusantara-ventures/goldprice-skills

# goldprice.dev — integration basics Live gold, silver, and copper pricing over REST + MCP. **Start free, no credit card.** Several endpoints need no key at all (see below), so you can build and demo before anyone signs up. - **Base URL:** `https://api.goldprice.dev` - **Docs for agents:** `https://goldprice.dev/llms-full.txt` · **OpenAPI:** `https://api.goldprice.dev/openapi.json` - **MCP:** `npx -y @goldprice/mcp` (drops into Claude Desktop / Cursor / Continue) ## Auth Authenticated endpoints use a Bearer token. Get a free `ga_live_...` key from the self-serve onboarding at https://goldprice.dev (no card). ```bash curl -H "Authorization: Bearer ga_live_..." \ "https://api.goldprice.dev/v1/prices?symbol=XAU-USD-SPOT" ``` **No key required** for: `/v1/carat`, `/v1/convert`, `/v1/prices/divergence` (count), `/v1/status`, `/v1/metadata/tiers`. Build the whole retail-conversion flow keyless. ## Symbol grammar — `BASE-QUOTE-CONTRACT` Always three tokens. Examples: `XAU-USD-SPOT`, `XAU-USD-FUTURES`, `XAG-USD-SPOT`, `HG-USD-FUTURES`. - Contract token is `SPOT` or `FUTURES` — **never `FUT`**. - A bare `symbol=XAU` returns `400 invalid_symbol`. Always send the full triplet. - Bases: `XAU` (all tiers), `XAG` + `HG` (Pro and up). ## Tiers (what a non-paying caller gets) | Tier | $/mo | Metals | Contracts | Rate / quota | Commercial | |---|---|---|---|---|---| | Free | 0 | XAU | spot (31 ccy) | 30/min · 1k/mo | No (internal) | | Physical | 10 | XAU | + futures, 1yr history,