True cost calculator
true_costAll-in delivered cost of a bullion order. Mode 1 (your_quote): give price, quantity, shipping, and payment fee to total your own quote (with below-spot warning if under melt). Mode 2 (dealer_ranking): give a tracked product and quantity to rank US dealers by delivered total using published shipping and payment fees, with per-dealer unavailability reasons and a stale-shipping warning when fee rules are >7 days old. 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": {
"product": "american-silver-eagle-1oz",
"quantity": 20
},
"name": "true_cost"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| price | No | Mode 1: price per item in USD. | |
| payment | No | Mode 2: pay by check/ACH/wire (bank) or credit card. | bank |
| product | No | Tracked product slug or name with its weight (see list_products). Mode 2 when price is not given; in mode 1 it adds per-ounce cost and premium. | |
| quantity | No | Number of units to buy (1-10000). Default 1. | |
| shipping | No | Mode 1: shipping charge for the whole order in USD. | |
| payment_fee_pct | No | Mode 1: payment method fee as a percent of the item total (for example 3.5 for a card surcharge). | |
| payment_fee_usd | No | Mode 1: flat payment fee in USD (for example a wire fee). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | No | ||
| mode | No | ||
| note | No | ||
| tool | No | ||
| error | No | ||
| stale | No | ||
| terms | No | ||
| credit | No | ||
| ranked | No | ||
| payment | No | ||
| product | No | ||
| quantity | No | ||
| freshness | No | ||
| items_usd | No | ||
| spot_asof | No | ||
| below_spot | No | ||
| data_as_of | No | ||
| deprecated | No | ||
| not_ranked | No | ||
| source_url | No | ||
| attribution | No | ||
| spot_source | No | ||
| shipping_usd | No | ||
| customization | No | ||
| canonical_tool | No | ||
| melt_value_usd | No | ||
| pct_below_spot | No | ||
| payment_fee_usd | No | ||
| deprecation_note | No | ||
| below_spot_warning | No | ||
| price_per_item_usd | No | ||
| shipping_fees_read | No | ||
| dealers_unavailable | No | ||
| delivered_total_usd | No | ||
| shipping_fees_stale | No | ||
| delivered_per_ozt_usd | No | ||
| delivered_premium_pct | No | ||
| delivered_per_item_usd | No | ||
| shipping_fees_age_days | No | ||
| shipping_stale_warning | No |