{"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","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","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":{"lang":{"type":"string","description":"Response language (ISO 639-1) | en | es | fr | pt | zh | ja | ko | de | ar"},"commodity":{"type":"string","description":"Mining commodity | lithium | cobalt | nickel | copper | gold | silver | uranium | graphite | REE | platinum | palladium | manganese | zinc | lead | tin | molybdenum | tungsten"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"errors":{"type":"object","description":"Documented error responses, keyed by HTTP status code","additionalProperties":{"type":"object","required":["description"],"properties":{"example":{"type":"object"},"description":{"type":"string"}}}},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","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":null,"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-09-14T00:41:33.737Z","isFirstParty":false}