get_dealer_prices

Current listed dealer prices for one tracked product, lowest first. Sorted by price only: dealers marked "Partner" pay to list and are never ranked by anything but price. Only prices checked in the last 24 hours are returned.

read-only

Argument	Type	Description
limit	integer	Maximum number of dealers to return.
payment	string	bank = check/ACH/wire price (default); card = the dealer's listed credit card price.
product*	string	Product slug from list_products (for example american-silver-eagle-1oz) or a name such as "silver eagle".

Input schema (JSON)

{
  "type": "object",
  "required": [
    "product"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 20,
      "minimum": 1,
      "description": "Maximum number of dealers to return."
    },
    "payment": {
      "enum": [
        "bank",
        "card"
      ],
      "type": "string",
      "default": "bank",
      "description": "bank = check/ACH/wire price (default); card = the dealer's listed credit card price."
    },
    "product": {
      "type": "string",
      "description": "Product slug from list_products (for example american-silver-eagle-1oz) or a name such as \"silver eagle\"."
    }
  },
  "additionalProperties": false
}

get_premium_index

Current Bullion Premium Index: for each tracked product, the lowest premium over spot today, the dealer median premium and the 7-day median and minimum of the lowest premium.

read-only

Argument	Type	Description
metal	string

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "metal": {
      "enum": [
        "gold",
        "silver",
        "platinum"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}

get_spot_prices

Live gold, silver and platinum spot prices in USD per troy ounce, with the time each was read and the gold-silver ratio.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

gold_silver_ratio

Live gold-silver ratio (ounces of silver one ounce of gold buys at spot), with an optional ounce converter.

read-only

Argument	Type	Description
direction	string
amount_ozt	number	Troy ounces to convert.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "direction": {
      "enum": [
        "gold_to_silver",
        "silver_to_gold"
      ],
      "type": "string",
      "default": "gold_to_silver"
    },
    "amount_ozt": {
      "type": "number",
      "minimum": 0,
      "description": "Troy ounces to convert."
    }
  },
  "additionalProperties": false
}

junk_silver_melt

Silver content and melt value of US junk silver coins by face value: 90% (pre-1965 dimes, quarters, halves), 40% (1965-1970 Kennedy halves or Eisenhower dollars) or 35% (1942-1945 war nickels). For 90% coins it also shows the 0.715 oz worn-coin figure and today's lowest dealer ask per $1 face.

read-only

Argument	Type	Description
coin_type	string	90 = 90% silver; 40 = 40% Kennedy halves; 40_eisenhower = 40% Eisenhower dollars; 35 = 35% war nickels.
face_value*	number	Total face value in US dollars, for example 10 for $10 face.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "face_value"
  ],
  "properties": {
    "coin_type": {
      "enum": [
        "90",
        "40",
        "40_eisenhower",
        "35"
      ],
      "type": "string",
      "default": "90",
      "description": "90 = 90% silver; 40 = 40% Kennedy halves; 40_eisenhower = 40% Eisenhower dollars; 35 = 35% war nickels."
    },
    "face_value": {
      "type": "number",
      "description": "Total face value in US dollars, for example 10 for $10 face.",
      "exclusiveMinimum": 0
    }
  },
  "additionalProperties": false
}

list_products

List the bullion products Bullion Price Check tracks (slug, name, metal, troy oz) with today's lowest listed dealer price for each. Use a slug with get_dealer_prices.

read-only

Argument	Type	Description
metal	string	Only list products of this metal.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "metal": {
      "enum": [
        "gold",
        "silver",
        "platinum"
      ],
      "type": "string",
      "description": "Only list products of this metal."
    }
  },
  "additionalProperties": false
}

melt_value

Melt (metal) value of any gold, silver or platinum item at live spot: weight x purity x spot. Weight in troy oz, grams, kilograms or pennyweight.

read-only

Argument	Type	Description
unit	string	ozt = troy ounce, g = gram, kg = kilogram, dwt = pennyweight.
metal*	string
purity	number	Metal fineness as a fraction, for example 0.999, 0.9167 (22k), 0.925 (sterling), 0.90 (US 90% coins).
weight*	number	Gross weight of the item.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "metal",
    "weight"
  ],
  "properties": {
    "unit": {
      "enum": [
        "ozt",
        "g",
        "kg",
        "dwt"
      ],
      "type": "string",
      "default": "ozt",
      "description": "ozt = troy ounce, g = gram, kg = kilogram, dwt = pennyweight."
    },
    "metal": {
      "enum": [
        "gold",
        "silver",
        "platinum"
      ],
      "type": "string"
    },
    "purity": {
      "type": "number",
      "default": 1,
      "maximum": 1,
      "description": "Metal fineness as a fraction, for example 0.999, 0.9167 (22k), 0.925 (sterling), 0.90 (US 90% coins).",
      "exclusiveMinimum": 0
    },
    "weight": {
      "type": "number",
      "description": "Gross weight of the item.",
      "exclusiveMinimum": 0
    }
  },
  "additionalProperties": false
}

premium_over_spot

Premium over spot for a price you were quoted. Give a tracked product slug to also see where the price sits against today's lowest, median and highest listed dealer prices, or give metal and weight for any item.

read-only

Argument	Type	Description
metal	string	Use with weight_ozt when the item is not a tracked product.
price*	number	Price quoted for one item, in USD.
payment	string	Which dealer price list to compare with (tracked products only).
product	string	Tracked product slug or name (see list_products).
weight_ozt	number	Pure metal content in troy ounces (use with metal).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "price"
  ],
  "properties": {
    "metal": {
      "enum": [
        "gold",
        "silver",
        "platinum"
      ],
      "type": "string",
      "description": "Use with weight_ozt when the item is not a tracked product."
    },
    "price": {
      "type": "number",
      "description": "Price quoted for one item, in USD.",
      "exclusiveMinimum": 0
    },
    "payment": {
      "enum": [
        "bank",
        "card"
      ],
      "type": "string",
      "default": "bank",
      "description": "Which dealer price list to compare with (tracked products only)."
    },
    "product": {
      "type": "string",
      "description": "Tracked product slug or name (see list_products)."
    },
    "weight_ozt": {
      "type": "number",
      "description": "Pure metal content in troy ounces (use with metal).",
      "exclusiveMinimum": 0
    }
  },
  "additionalProperties": false
}

scrap_gold_value

Full melt value of scrap gold or jewelry by karat and weight at live gold spot (karat/24, with 24k at 99.9%). Optionally give an offer to see what share of melt it is.

read-only

Argument	Type	Description
unit	string	g = gram, dwt = pennyweight, ozt = troy ounce.
karat*	number	Gold karat, for example 10, 14, 18, 22 or 24.
weight*	number
offer_usd	number	Optional offer you received, to compare with melt.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "karat",
    "weight"
  ],
  "properties": {
    "unit": {
      "enum": [
        "g",
        "dwt",
        "ozt"
      ],
      "type": "string",
      "default": "g",
      "description": "g = gram, dwt = pennyweight, ozt = troy ounce."
    },
    "karat": {
      "type": "number",
      "maximum": 24,
      "minimum": 1,
      "description": "Gold karat, for example 10, 14, 18, 22 or 24."
    },
    "weight": {
      "type": "number",
      "exclusiveMinimum": 0
    },
    "offer_usd": {
      "type": "number",
      "description": "Optional offer you received, to compare with melt.",
      "exclusiveMinimum": 0
    }
  },
  "additionalProperties": false
}

true_cost

Delivered cost of a bullion order. Mode 1: give price (per item), quantity, shipping and a payment fee to get the all-in total. Mode 2: give a tracked product and quantity (no price) to rank dealers by delivered total using each dealer's published shipping and payment fees.

read-only

Argument	Type	Description
price	number	Mode 1: price per item in USD.
payment	string	Mode 2: pay by check/ACH/wire (bank) or credit card.
product	string	Tracked product slug or name. Mode 2 when price is not given; in mode 1 it adds per-ounce cost and premium.
quantity	integer
shipping	number	Mode 1: shipping charge for the whole order in USD.
payment_fee_pct	number	Mode 1: payment method fee as a percent of the item total (for example 3.5 for a card surcharge).
payment_fee_usd	number	Mode 1: flat payment fee in USD (for example a wire fee).

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "price": {
      "type": "number",
      "description": "Mode 1: price per item in USD.",
      "exclusiveMinimum": 0
    },
    "payment": {
      "enum": [
        "bank",
        "card"
      ],
      "type": "string",
      "default": "bank",
      "description": "Mode 2: pay by check/ACH/wire (bank) or credit card."
    },
    "product": {
      "type": "string",
      "description": "Tracked product slug or name. Mode 2 when price is not given; in mode 1 it adds per-ounce cost and premium."
    },
    "quantity": {
      "type": "integer",
      "default": 1,
      "maximum": 10000,
      "minimum": 1
    },
    "shipping": {
      "type": "number",
      "default": 0,
      "minimum": 0,
      "description": "Mode 1: shipping charge for the whole order in USD."
    },
    "payment_fee_pct": {
      "type": "number",
      "default": 0,
      "maximum": 20,
      "minimum": 0,
      "description": "Mode 1: payment method fee as a percent of the item total (for example 3.5 for a card surcharge)."
    },
    "payment_fee_usd": {
      "type": "number",
      "default": 0,
      "minimum": 0,
      "description": "Mode 1: flat payment fee in USD (for example a wire fee)."
    }
  },
  "additionalProperties": false
}

Bullion Price Check

Try it

get_dealer_prices Read-only

Bullion Price Check

Try it

get_dealer_prices Read-only

Install

Tools (10)

Security checkA100/100