{"uid":"cap_4K5-rS2dkq0QgWggISBVm","slug":"prereason-gold-miners-dashboard-dd571aef","name":"PreReason Gold Miners Dashboard","description":"Financial market context for AI agents: macro, rates, bonds, FX, commodities, companies and Bitcoin. One API call returns a briefing with the reasoning already in it.","url":"https://api.prereason.com/api/commodities/gold-miners?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Historical date in YYYY-MM-DD format. A paid call serves today or any ?date= on record."},"format":{"enum":["json","markdown"],"type":"string","description":"Response format. markdown is token-optimized for LLMs, json is structured. Default is markdown."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"metrics":{"etf-gld":{"name":"etf-gld"},"wb-gold-usd-oz":{"name":"wb-gold-usd-oz"}},"briefing_used":"commodities.gold-miners","briefing_metadata":{"name":"Gold and the Miners","description":"The gold fund GLD and the covered USA companies tied to gold by their own annual reports, side by side: the World Bank's monthly gold price as context, then each gold and silver miner and each royalty and streaming company with its share price, its change over 1, 3 and 12 months beside GLD over the same windows, the 90 day correlation of its daily changes with GLD, and the id of its own briefing for its filed figures. GLD is a fund's share price, not the gold price. Each group in order of stored market capitalisation; it describes, it does not rank.","metrics_count":2,"correlations_count":0}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9mjN9vr9achbhdXBdpPbU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns GLD ETF share price, World Bank monthly gold price, and comparative performance data for covered US gold and silver miners and royalty/streaming companies","exampleAgentPrompt":"Show me today's gold miners dashboard — GLD share price, World Bank gold price, and how all the covered US gold and silver miners and royalty companies compare, with their 1, 3, and 12-month changes and correlation to GLD.","exampleUseCases":[{"title":"Daily gold sector equity briefing","prompt":"Pull today's gold miners dashboard and give me a summary of how GLD and all the covered US gold miners and streaming companies are performing, including their 1-month and 12-month changes."},{"title":"Historical gold miner snapshot for research","prompt":"Get me the gold miners data for 2024-08-15 — I want to see GLD's share price, the World Bank gold price, and how the US gold and silver miners were doing that day versus GLD over 1, 3, and 12 months."},{"title":"Gold royalty company correlation analysis","prompt":"I'm building a portfolio model — can you fetch the current PreReason gold miners briefing so I can see the 90-day correlations of US gold royalty and streaming companies with GLD?"}],"resultDescription":"A structured dataset (JSON or markdown) containing: GLD ETF share price, World Bank monthly average gold price per troy ounce, and for each covered US gold miner, silver miner, and royalty/streaming company — share price, price change over 1, 3, and 12 months, 90-day daily-change correlation with GLD, market capitalisation ranking within group, and a briefing ID for detailed filed figures. Groups are ordered by stored market capitalisation.","failureModes":["Invalid date format returns a schema validation error — must be YYYY-MM-DD","Date not in historical record returns an empty or error response","Invalid format parameter (not 'json' or 'markdown') may default or error","Network/payment failure at x402 layer results in 402 Payment Required"],"whenToPreferThis":"Choose this endpoint when you need a side-by-side view of GLD ETF performance and US gold/silver miner equities with multi-horizon comparisons and GLD correlation in a single call. It is specifically optimised for AI agent consumption (markdown mode is token-efficient) and covers both miners and royalty/streaming companies. Prefer this over generic stock APIs when you want pre-curated, contextualised gold-sector equity data with World Bank gold price as macro context.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:40:17.287Z","isFirstParty":false,"canonicalSlug":"prereason-gold-miners-dashboard-dd571aef"}