# Lone Star Oracle Critical Minerals Supply Signal

> Lone Star Oracle Critical Minerals Supply Signal is a paid API for AI agents from minerals.lonestaroracle.xyz, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-13).

Returns US import reliance, world mine-production concentration, reserves data, and USGS critical-mineral status for a given mineral commodity

## Facts

- Endpoint: GET https://minerals.lonestaroracle.xyz/minerals
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lone-star-oracle-critical-minerals-supply-signal-de3a42d1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5AnhC4ihacojbd3K37Kgd

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 lone-star-oracle-critical-minerals-supply-signal-de3a42d1
```

Example prompt: What's the US import reliance and global supply concentration for rare earths — who controls world production and is it a USGS critical mineral?

## When to prefer this

Use this endpoint when you need authoritative, USGS-sourced data on critical mineral supply chains — specifically US import dependency, China/adversary production dominance, and geopolitical concentration risk — for sourcing decisions, policy analysis, investment screening, or supply-chain due diligence. Prefer this over generic commodity price feeds when the question is about structural supply risk rather than spot price.

## Known failure modes

- Unknown or misspelled commodity name returns no match or an error
- Commodity outside the ~70+ supported list returns empty result
- Network timeout or payment failure via x402 returns 402 or 5xx
- HEAD or DELETE requests return no body despite being allowed by schema

## How this service works

Critical-minerals supply-concentration & US import-reliance signal

## Output

A structured signal including: the commodity name, whether it is a USGS-designated critical mineral, US net import reliance percentage with named foreign sources, ranked top world mine producers with country share percentages, China's mine production share, an HHI-style concentration score, and reserves concentration by country.

## Request schema (JSON Schema)

```json
{
 "name": "StrategicMaterials",
 "tags": [
  "critical-minerals",
  "rare-earths",
  "supply-chain",
  "geopolitics",
  "commodities",
  "mining",
  "macro"
 ],
 "type": "object",
 "version": "1.0.0",
 "category": "trading",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "commodity": {
       "type": "string",
       "title": "Commodity"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "signal": "Rare earths: US 80% net-import-reliant (sources: China, Malaysia, Japan, Estonia). China leads world mine production at 69% (top 3 = 86%). Very high supply concentration. USGS-designated critical mineral.",
     "commodity": "Rare earths",
     "is_critical_mineral": true,
     "us_net_import_reliance_pct": 80
    }
   }
  }
 },
 "description": "Critical-minerals supply-concentration & US import-reliance signal. For a mineral commodity (rare earths, gallium, germanium, cobalt, lithium, graphite, antimony, tungsten, nickel, platinum-group metals, and 70+ more), returns: world mine-production concentration by country (ranked top producers with share, China's share, and an HHI concentration score), US net import reliance and the major foreign sources, reserves concentration by country, and whether it is a USGS-designated critical mineral. Use it to assess supply-chain and geopolitical exposure — China/adversary control of a mineral, US import dependence, and single-country concentration — before a sourcing, policy, or investment decision. Pay-per-call $0.05 in USDC on Base via x402. Data = USGS Mineral Commodity Summaries 2025, US government public domain."
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lone-star-oracle-critical-minerals-supply-signal-de3a42d1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from minerals.lonestaroracle.xyz](https://www.zero.xyz/host/minerals.lonestaroracle.xyz/llms.txt)