{"uid":"cap_asG4UFyj_H1oz1ZpkqV2s","slug":"prospectpulse-commodity-supply-demand-intelligence-ddbf27bf","name":"ProspectPulse Commodity Supply-Demand Intelligence","description":"Global supply and demand analysis for any mining commodity (Li, Co, Ni, Cu, REE, Au, Ag, Pt, U, graphite) for commodity and mining-investment agents, with energy-transition context on where structural deficits are forming.","url":"https://prospectpulse.theaslangroupllc.com/api/prospect/commodity-supply-intel?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","errors":{"400":{"example":{"error":"invalid request"},"description":"Invalid or missing parameter(s). Returned before the payment gate on paid requests, so a malformed call is never charged. JSON body: { error: <what is wrong and how to fix it> } plus usage hints."},"402":{"description":"Payment required — x402 v2 challenge; the accepts array lists scheme, network, and amount. Retry the same request with a PAYMENT-SIGNATURE (v2) or X-PAYMENT (v1) header. Verification is free."},"500":{"example":{"error":"upstream_failed"},"description":"Unexpected server error. If a payment settled without a usable result, contact info@theaslangroupllc.com with the settlement tx hash for a re-run or credit."}},"example":{"balance":"SURPLUS","commodity":"Lithium","commodity_type":"CRITICAL MINERAL","analyst_summary":"Lithium faces near-term oversupply as 2022-2023 project rush delivers into weaker-than-expected EV demand...","global_production_summary":{"top_producers":[{"country":"Australia","share_pct":47},{"country":"Chile","share_pct":30}],"concentration_risk":"MODERATE","annual_production_kt":"~180 kt LCE (2024)"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.2","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":{"p10Cents":"20.0000","medianCents":"20.0000","p90Cents":"20.0000","minCents":"20.0000","maxCents":"20.0000","p95Cents":"20.0000","sampleCount":1,"varies":false,"failureChargeRate":1},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.2/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ye39qbpX1kp9kiASSCZit","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.2","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns global supply and demand analysis for a specified mining commodity, including structural deficit forecasts and energy-transition context.","exampleAgentPrompt":"Give me a full global supply and demand analysis for lithium, including where structural deficits are forming and how the energy transition is driving demand — I need it for a mining investment thesis.","exampleUseCases":null,"resultDescription":"A structured report covering global supply and demand dynamics for the requested mining commodity, identification of structural deficit regions or time horizons, energy-transition demand drivers (e.g. EV, battery storage, grid infrastructure), current market balance, and investment-relevant insights on where supply shortfalls are emerging.","failureModes":["Unsupported or unrecognized commodity name returns an error or empty result","Commodity specified outside the supported list (Li, Co, Ni, Cu, REE, Au, Ag, Pt, U, graphite) may return an error","Data freshness lag if underlying market data sources have not been recently updated","Payment failure or insufficient USDC balance blocks the call with a 402 response","Ambiguous commodity abbreviation (e.g. 'REE' vs specific rare earth) may return generalized results"],"whenToPreferThis":"Use this endpoint when an agent needs structured, investment-grade global supply-demand analysis for a specific mining or critical mineral commodity, particularly when energy-transition context and deficit identification are required. Prefer this over generic financial data APIs when the user's intent is mining-sector investment research or commodity market intelligence specific to the metals covered.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T19:03:06.706Z","isFirstParty":false,"canonicalSlug":"prospectpulse-commodity-supply-demand-intelligence-ddbf27bf"}