# StrategicMaterials

> StrategicMaterials is a paid API for AI agents from api.aidress.ai, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

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

## Facts

- Endpoint: GET https://api.aidress.ai/pay/agent_minerals_lonestaroracle_xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/strategicmaterials-7e93d008
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_R7vRUvNevqQuKbqmXgdRv

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 strategicmaterials-7e93d008
```

Example prompt: What's the US import reliance and global supply concentration for rare earths — how much does China dominate production and is it a USGS critical mineral?

## When to prefer this

Choose this endpoint when you need authoritative, USGS-sourced data on US import dependence, global mine-production concentration, and critical mineral status for a specific commodity — especially when assessing geopolitical or adversary-control risk (e.g. China dominance). Prefer it over generic commodity price feeds or news APIs when the question is about structural supply-chain vulnerability rather than spot prices or market sentiment.

## Known failure modes

- Commodity name not recognized or misspelled — returns error or empty result
- Commodity not covered in USGS Mineral Commodity Summaries 2025 dataset — no data available
- Payment failure via x402/USDC on Base — request rejected before data is returned
- Rate limiting or API unavailability — transient 5xx error

## How this service works

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

## Output

Returns a structured signal including the commodity name, US net import reliance percentage, list of major foreign supply sources, ranked top-producing countries with production share percentages, China's specific share, an HHI concentration score, reserves concentration by country, and a boolean flag for USGS critical mineral designation. An example output includes fields like signal (narrative summary), commodity, is_critical_mineral, and us_net_import_reliance_pct.

## 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/strategicmaterials-7e93d008/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.aidress.ai](https://www.zero.xyz/host/api.aidress.ai/llms.txt)