{"uid":"cap_5AnhC4ihacojbd3K37Kgd","slug":"lone-star-oracle-critical-minerals-supply-signal-de3a42d1","name":"Lone Star Oracle Critical Minerals Supply Signal","description":"Critical-minerals supply-concentration & US import-reliance signal","url":"https://minerals.lonestaroracle.xyz/minerals","method":"GET","headers":{},"bodySchema":{"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."},"responseSchema":null,"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_a3CZlD-iusNcd1SNbAug3","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 US import reliance, world mine-production concentration, reserves data, and USGS critical-mineral status for a given mineral commodity","exampleAgentPrompt":"What's the US import reliance and global supply concentration for rare earths — who controls world production and is it a USGS critical mineral?","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:32:30.289Z","isFirstParty":false}