Observed premiums over spot
get_observed_premiumsRolling fine-metal-weighted median asking premiums for silver, gold, platinum, palladium, copper, nickel and Goldback, observed from marketplace listings.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"metal": "<metal>"
},
"name": "get_observed_premiums"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Product page size. Without a query, pages browse the most-listed products. | |
| metal | Yes | Which metal's observed premiums to return. | |
| query | No | Case-insensitive product label/canonical-key search. | |
| cursor | No | Opaque continuation token returned by the same tool with exactly the same filters. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| asOf | Yes | UTC latest observation instant. | |
| metal | Yes | ||
| overall | Yes | ||
| products | Yes | ||
| sourceUrl | Yes | ||
| categories | Yes | ||
| nextCursor | Yes | ||
| windowDays | Yes | ||
| productOrder | Yes | How product rows were selected: search (query match, catalog order) or listing_count (browse, most-listed first). Empty products means no data. | |
| productQuery | Yes | ||
| minimumListings | Yes |