# PreReason Gold Miners Dashboard

> PreReason Gold Miners Dashboard is a paid API for AI agents from api.prereason.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-12).

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

## Facts

- Endpoint: GET https://api.prereason.com/api/commodities/gold-miners?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/prereason-gold-miners-dashboard-dd571aef
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4K5-rS2dkq0QgWggISBVm

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability prereason-gold-miners-dashboard-dd571aef
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/prereason-gold-miners-dashboard-dd571aef/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.prereason.com](https://www.zero.xyz/host/api.prereason.com/llms.txt)