13 metals (copper, aluminum, nickel, steel, lithium, iron ore, zinc, uranium, rare earths, gold, silver, platinum, palladium) with momentum signals and category-level analysis. GET /report $0.05 via x402. NEW: each metal includes 52-week range context — where the price sits within its own year (fields percentile_1y, vs_range, high_52w/low_52w).
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. By signing up you are subscribing to the APIs.io and API Evangelist
newsletters — you can unsubscribe from any issue. See our
Privacy Policy and Terms.
openapi: 3.2.0
info:
title: LoneStarOracle — full catalog Industrialmetals API
version: 1.20261117.1
description: Every LoneStarOracle pay-per-call data service in one document. Call each endpoint at its own host (x-direct-url on each operation; `url` in catalog.json). That direct URL is the resource the 402 challenge names, so x402 clients pay and retry cleanly. Gateway paths https://lonestaroracle.xyz/api// (gateway_url) only 307-redirect to the direct URL; never pay at the proxy. Paid endpoints return HTTP 402 with x402 payment requirements (USDC on Base or Solana); pay and retry. No API keys, no accounts. Price per call is in x-payment-info.
contact:
email: info@lonestaroracle.xyz
x-guidance: 'Agents: fetch this one document; do not crawl per-service hosts. Base URL https://lonestaroracle.xyz/api/<service>/<path> forwards to each service (x-direct-url on each operation is the same endpoint on its own host; both work). Every operation carries x-payment-info: authMode ''free'' needs no payment; authMode ''payment'' returns HTTP 402 with the requirements in the base64 ''payment-required'' response header (x402 v2; a v1 body is also sent for legacy clients). Pay USDC on Base (eip155:8453) or Solana and retry with the payment header; settlement happens only on a successful (2xx) response, so a 4xx such as an unknown category or a missing parameter is never charged. Query-parameter names are in each operation; common synonyms are accepted (e.g. ticker/symbol, country/location). Prices are fixed per call and listed in x-payment-info.price.amount (USD). info.version changes whenever any path, parameter, price or schema changes (x-content-hash is the sha256 of paths+components), so re-pull only when it moves. Flat list: https://lonestaroracle.xyz/catalog.json. Payment manifest: https://lonestaroracle.xyz/.well-known/x402. Feedback (free, no payment, no key): POST any JSON to https://lonestaroracle.xyz/feedback (what you wanted, what was missing, what you would pay); GET it for the suggested fields. Trialability (added 2026-10-05): each operation carries x-example (a real worked request/response), x-edge-cases (how empty, partial, bad-input and error results are represented), x-provenance (data freshness) and x-service-version (pin it; it changes only when that service''s paths, parameters or schema change). Contact: jay@lonestaroracle.xyz.'
x-content-hash: a415b2385083d038b66621b6e2914e1146ffe53354e39e473f6493078f509f72
x-changed-at: '2026-11-17T06:40:26Z'
servers:
- url: https://lonestaroracle.xyz/api
tags:
- name: industrialmetals
x-displayName: IndustrialMetals
x-service-slug: metals
description: '13 metals (copper, aluminum, nickel, steel, lithium, iron ore, zinc, uranium, rare earths, gold, silver, platinum, palladium) with momentum signals and category-level analysis. GET /report $0.05 via x402. NEW: each metal includes 52-week range context — where the price sits within its own year (fields percentile_1y, vs_range, high_52w/low_52w).'
x-direct-host: https://metals.lonestaroracle.xyz
x-service-version: 058ee5d43a2f
x-provenance:
sources:
- official and public market data
freshness: live reads at request time; not stale-cached
paths:
/metals/report:
get:
summary: Industrial Metals Prices
operationId: metals_report_report_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
example:
service: IndustrialMetals
fetched_at: '2026-09-16T00:39:48.408666+00:00'
metals: '{...}'
category_signals: '{...}'
ai_summary: '# Industrial Metals Market Update
The broad selloff across all metal categories reflects weakening global manufacturing demand and recession concerns, with strategic and battery metals hit hardest as investors price in slower EV adoption and capital expenditure pullbacks. The modest -1.8% decline in base metals signals that industrial activity hasn''t collapsed but is contracting—watch copper and aluminum closely as canaries for real-world construction and manufacturing momentum. Over the next 30 days, monitor whether this decline stabilizes at current levels or accelerates; a break below the -3% range for base metals would suggest demand destruction rather than normal volatility, while any reversal in rare earths and lithium could indicate supply-side tightening offsetting demand weakness. Key catalyst to watch: manufacturing PMI data and earnings guidance from major industrial OEMs, which will clarify whether this is cyclical weakness or the start of a deeper contraction.'
note: Futures prices where available. Steel, Lithium, Uranium, Rare Earths are ETF proxies.
provider: IndustrialMetals - LoneStarOracle
'402':
description: Payment Required
x-payment-info:
authMode: payment
price:
mode: fixed
currency: USD
amount: '0.050000'
security:
- x402: {}
description: Copper, aluminum, steel and industrial-metals pricing and momentum.
tags:
- industrialmetals
x-direct-url: https://metals.lonestaroracle.xyz/report
x-service-version: 058ee5d43a2f
x-provenance:
sources:
- official and public market data
freshness: live reads at request time; not stale-cached
x-example:
request: {}
response:
service: IndustrialMetals
fetched_at: '2026-09-16T00:39:48.408666+00:00'
metals: '{...}'
category_signals: '{...}'
ai_summary: '# Industrial Metals Market Update
The broad selloff across all metal categories reflects weakening global manufacturing demand and recession concerns, with strategic and battery metals hit hardest as investors price in slower EV adoption and capital expenditure pullbacks. The modest -1.8% decline in base metals signals that industrial activity hasn''t collapsed but is contracting—watch copper and aluminum closely as canaries for real-world construction and manufacturing momentum. Over the next 30 days, monitor whether this decline stabilizes at current levels or accelerates; a break below the -3% range for base metals would suggest demand destruction rather than normal volatility, while any reversal in rare earths and lithium could indicate supply-side tightening offsetting demand weakness. Key catalyst to watch: manufacturing PMI data and earnings guidance from major industrial OEMs, which will clarify whether this is cyclical weakness or the start of a deeper contraction.'
note: Futures prices where available. Steel, Lithium, Uranium, Rare Earths are ETF proxies.
provider: IndustrialMetals - LoneStarOracle
x-edge-cases:
behavior: No params to misuse. Fields not yet released upstream return null (never estimated); a warming cache returns 503 'retry', not stale data.
bad_input: Null/empty fields, never a fabricated result.
partial_data: Unsourced fields are null, never guessed.
on_error: A 5xx settles nothing under x402 - you are not charged for a failed call.
x-latency:
p50_ms: null
p95_ms: null
samples: null
measured: 1 live call, 2026-09-16 (single sample)
externalDocs:
url: https://docs.lonestaroracle.xyz