get_spot_prices
Get spot prices
Current spot prices per troy ounce in USD for gold, silver, platinum and palladium, as used by Bullion Trading LLC: the Ask (what our prices and premiums are measured over) and the Bid (what buy-back rates start from), with the change since the previous 5 pm New York close. Use when the user asks for the current gold, silver, platinum or palladium price. Read-only.
Parametersmetals
search_products
Search products
Search the Bullion Trading LLC catalog of gold, silver, platinum and palladium coins, bars and rounds. Filter by metal, type, price range and stock; sort by price, popularity or newest. Returns both prices (check/wire and card/PayPal, +5%) and in/out of stock. Use when the user wants to find or compare Bullion Trading LLC products. Read-only; it cannot add to a cart or place an order.
Parameterspagesorttypemetalqueryper_pagemax_pricemin_pricein_stock_only
Full details for one product by id, slug or product URL: both prices, quantity price tiers, in/out of stock, metal, weight, purity, mint, a short description, what we pay to buy it back (if we do) and a price-history link. Use when the user asks about one specific Bullion Trading LLC product. Read-only.
Parametersproductrequired
The "Find your bullion" picker: products matching a metal, form, size, purpose or sort order, as on bulliontradingllc.com/find-your-bullion/, with both prices, in/out of stock and the best price per ounce. Sizes look like "1-oz", "1-10-oz", "10-oz", "1-kilo", "1-gram". Use when the user describes what they want (metal, form, size, budget) and needs matching Bullion Trading LLC products. Read-only.
Parameterssizesorttypemetalstatepurpose
Today's typical and lowest premium over the Ask spot for each standard coin and bar format (1 oz gold coins, 1 oz gold bars, silver rounds, kilo bars…) at Bullion Trading LLC, with the 2-year median and the lowest-premium product. Use when the user asks how far Bullion Trading LLC prices sit above spot, by format. Read-only.
Parametersmetal
get_buyback_price
Get buy-back price
What Bullion Trading LLC pays when you sell bullion to us: posted per-item rates (gold, platinum and palladium at spot bid minus 3% or 5%; silver at spot bid minus $3 or $5 per oz). Posted rates, not locked quotes. $1,000 minimum per sale. Use when the user asks what Bullion Trading LLC pays to buy an item back. Read-only; posted rates, not a locked quote.
Parametersmetalsearchproduct
estimate_sales_tax
Estimate sales tax
Whether a US state charges sales tax on bullion, the threshold if any, and an estimate for an order amount. Estimate only; the final tax is shown at checkout. Includes the state page link. Use when the user asks about US sales tax on a bullion purchase. Read-only; not tax advice.
Parametersformmetalstaterequiredamount
get_store_info
Get store info
Bullion Trading LLC contact and location: address on West 47th Street (New York), phone, emails, opening hours (New York time), year founded, licensing and map link. Use when the user asks about Bullion Trading LLC's address, hours, contact or licence. Read-only.
Takes no parameters.
Bullion Trading LLC policies in the store's own wording: shipping (US only), payment methods and limits, returns, state minimums, NYC pickup, and selling to us. Use when the user asks about Bullion Trading LLC's shipping, returns, payment or ordering policies. Read-only.
Parameterstopic
Products on the Bullion Trading LLC deals page today, with why each one is a deal (for example the lowest premium in its format). Both prices and in/out of stock. Use when the user asks which Bullion Trading LLC products are featured on its deals page. Read-only.
Parameterslimitmetal
get_price_history
Get price history
Price history for either one product (its past check/wire prices) or a metal (daily closes, up to a 5-year span). Give product, or metal with optional from/to dates (default: the last 12 months). Use when the user asks how a metal's price has moved over a past period. Read-only; past data, not a forecast.
Parameterstofrommetalproduct
get_market_news
Get market news
The precious-metals market news summary for a day (default the latest): market mood, headline, a short summary, key points, source headlines with links, and the weekly recap link. Use when the user asks for the day's precious-metals market news summary. Read-only; news summary, not advice.
Parametersdate
Best-value options for a budget in USD and a metal: which product and how many pieces fit, the payment method the total assumes (check/wire from $1,000, otherwise card/PayPal at +5%), the total and the premium over spot. Goal can favour the lowest premium, popular coins, or gift-friendly items. Before shipping and tax. Use when the user gives a budget and a metal and wants to see what fits. Read-only; it is a calculation, not a purchase.
Parametersgoalmetalbudgetrequired
ratio_swap
Gold/silver ratio swap
The current gold/silver ratio (ounces of silver one ounce of gold buys at spot), with an optional swap: give gold_oz to see the silver ounces it equals, or silver_oz for the gold ounces. Spot-to-spot only; premiums and buy-back spreads are not included. Use when the user asks for the gold/silver ratio or a spot-to-spot conversion. Read-only.
Parametersgold_ozsilver_oz
list_best_sellers
List best sellers
The best-selling products at Bullion Trading LLC, optionally for one metal. Both prices and in/out of stock. Use when the user asks which Bullion Trading LLC products sell best. Read-only.
Parameterslimitmetal
list_new_arrivals
List new arrivals
Products newly added to the Bullion Trading LLC catalog, optionally for one metal. Both prices and in/out of stock. Use when the user asks what is new in the Bullion Trading LLC catalog. Read-only.
Parameterslimitmetal
Gold and silver gift ideas for traditions and occasions (for example Pidyon HaBen or Dhanteras): what the tradition calls for, the guide page, and suggested products with both prices. Use when the user wants Bullion Trading LLC gift ideas for an occasion. Read-only.
Parametersoccasion
get_mint_info
Get mint info
About a mint or refiner (Royal Canadian Mint, PAMP, US Mint…): country, a short summary, how many products we carry and a sample with both prices. Give a slug or search words; omit both to list mints. Use when the user asks about a mint or refiner and what Bullion Trading LLC carries from it. Read-only.
Parametersmintsearch