Dealer buy/sell quote from spot
quotePrice a dealer buy or sell ticket from the latest BPC spot (or caller-supplied spot override). Supports bullion (tracked products) and scrap (weight + unit + karat or purity; purity applied once). Includes default buy offer tiers (% of melt), sell margin rules, market ask percentiles, and published buyback bid benchmarks when available. Standard tool free; for a version fine-tuned or customized to your business, email for pricing via https://bullionpricecheck.com/contact/.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"side": "sell",
"product": "american-silver-eagle-1oz",
"margin_pct": 5
},
"name": "quote"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| side | No | sell = you sell to a customer; buy = you buy from a customer. Default: buy for scrap or when tier/offer_pct is given, else sell. | |
| spot | No | Optional spot price in USD per troy oz to use instead of Bullion Price Check's latest reading (gold-api.com). The answer labels it spot_source=caller. | |
| tier | No | Buy offer default tier (% of melt). Buy quotes without tier, offer_pct or margins use target. | |
| unit | No | Scrap weight unit: g = gram, dwt = pennyweight, ozt = troy ounce, kg = kilogram. | g |
| class | No | bullion = a tracked coin or bar (default when product is given); scrap = metal by weight and karat or purity. | |
| karat | No | Scrap gold karat: 24=.999, 22=.9167, 18=.75, 14=.5833, 10=.4167 (others karat/24). | |
| metal | No | Scrap metal. | gold |
| purity | No | Scrap fineness as a fraction (use instead of karat; required for silver or platinum scrap). | |
| weight | No | Scrap gross weight. | |
| product | No | Tracked product slug from list_products (for example american-silver-eagle-1oz) or a name with its weight. A name only matches a product of the same weight. | |
| quantity | No | Number of units (bullion) or identical scrap lots. | |
| offer_pct | No | Your own buy offer as % of melt; overrides the tier default. | |
| spot_asof | No | Optional ISO time of the spot you passed in, echoed back as spot_asof. | |
| margin_pct | No | Margin rule: percent over melt (sell) or under melt (buy). Not combined with tier/offer_pct. | |
| margin_usd | No | Flat USD per unit over melt (sell) or deducted (buy). | |
| valid_seconds | No | How long the quote is good for; sets expires_at. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | No | ||
| sku | No | ||
| rule | No | ||
| side | No | ||
| spot | No | ||
| tool | No | ||
| class | No | ||
| error | No | ||
| scrap | No | ||
| stale | No | ||
| terms | No | ||
| credit | No | ||
| product | No | ||
| quantity | No | ||
| rounding | No | ||
| unit_usd | No | ||
| freshness | No | ||
| quoted_at | No | ||
| spot_asof | No | ||
| total_usd | No | ||
| data_as_of | No | ||
| deprecated | No | ||
| disclaimer | No | ||
| expires_at | No | ||
| source_url | No | ||
| attribution | No | ||
| offer_tiers | No | ||
| pct_of_melt | No | ||
| premium_pct | No | ||
| spot_source | No | ||
| customization | No | ||
| valid_seconds | No | ||
| canonical_tool | No | ||
| market_context | No | ||
| melt_total_usd | No | ||
| deprecation_note | No | ||
| buyback_benchmark | No | ||
| melt_per_unit_usd | No |