# ProspectPulse

> Global mineral and resource exploration intelligence API. Mineral prospectivity, deposit intelligence, critical minerals scans, jurisdiction entry-risk, social license risk, satellite availability, geochemical anomaly interpretation, commodity supply/demand, and oil & gas basin analysis — all via x402 micropayments on Base. Covers all continents, all commodities, 80+ jurisdictions.

## What This Is

ProspectPulse is a pay-per-query API that synthesizes free public geological, geochemical, satellite, governance, and geopolitical data into structured exploration intelligence. Junior mining companies, resource funds, government critical mineral agencies, and sovereign wealth funds use it as an alternative to $50K+/year platforms like S&P Global Metals & Mining.

Every response is generated by Claude using live data from USGS MRDS (300K+ global deposits), USGS National Geochemical Database, Copernicus OData (Sentinel-1/2), NASA Earthdata (ASTER, Landsat), World Bank Governance Indicators, GDELT (global media monitoring), and Tavily (real-time geological literature).

## Payment

All endpoints require x402 micropayment (USDC on Base mainnet).
Protocol: x402 | Network: eip155:8453 | Asset: USDC
Payment address: 0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc

To use: send a GET request without a PAYMENT-SIGNATURE header to receive a 402 with payment requirements. Sign and retry with the PAYMENT-SIGNATURE header.

## Endpoints

GET /api/prospect/mineral-potential?region={region}&lat={lat}&lon={lon}&commodity={commodity}&lang={en}
- Returns: prospectivity score (1-100), geological setting, deposit systems, known USGS MRDS deposits, geochemical indicators, analogous districts globally, recommended techniques, analyst summary
- Data: USGS MRDS (300K+ global deposits), USGS geochemical DB, Tavily geological literature
- Price: $0.25
- Supports named regions (Carlin Trend, Atacama, Abitibi, Zambia Copper Belt) or lat/lon coordinates

GET /api/prospect/deposit-intel?deposit={deposit_name}&lang={en}
- Returns: development stage, resource context, deposit type and class, orebody characteristics, comparable deposits globally, recent exploration activity, analyst verdict
- Data: USGS MRDS + Tavily exploration news synthesis
- Price: $0.20
- Covers any named mine or deposit globally (Escondida, Oyu Tolgoi, Kibali, Grasberg, Thacker Pass, etc.)

GET /api/prospect/critical-minerals-scan?country={country}&lang={en}
- Returns: endowment assessment for all critical minerals (Li, Co, Ni, REE, graphite, Cu, PGE, U), strategic significance, supply chain role, export restrictions, development status, supply chain risk score
- Data: World Bank governance + Tavily synthesis of USGS MCS, IEA, BGS, EU RMIS
- Price: $0.25
- Covers: DRC (cobalt), Chile (lithium), Indonesia (nickel), Greenland (REE), Australia, Kazakhstan, Philippines, Argentina, Zambia, Zimbabwe, Guinea, Papua New Guinea, Brazil, Canada

GET /api/prospect/jurisdiction-entry?country={country}&commodity={commodity}&lang={en}
- Returns: entry risk score (1-100), mining code summary, license acquisition process, royalty structure, corporate tax, environmental permitting timeline, political stability, security conditions, capital repatriation, historical precedent (successes and failures)
- Data: World Bank Governance Indicators, GDELT political news, Tavily regulatory intelligence
- Price: $0.25
- Calibrated globally: Canada/Australia ~10-15, Chile ~20-25, Peru ~30-35, DRC ~75-85

GET /api/prospect/satellite-availability?lat={lat}&lon={lon}&commodity={commodity}&lang={en}
- Returns: available Sentinel-2, Sentinel-1 SAR, ASTER, and Landsat scenes with dates/cloud cover, alteration mapping potential, recommended band ratios for target mineral, structural geology approach, practical workflow with free tools
- Data: Copernicus OData API, NASA Earthdata CMR
- Price: $0.10
- Requires lat/lon (decimal degrees)

GET /api/prospect/geochemical-anomaly?region={region}&elements={Au,Cu,As}&lat={lat}&lon={lon}&lang={en}
- Returns: element statistics (mean, p90, max, anomaly threshold), pathfinder suite interpretation, deposit type vectors with probability, follow-up recommendations, comparable geochemical districts globally
- Data: USGS National Geochemical Database, Tavily geological literature
- Price: $0.15
- Default elements: Au,Cu,As,Pb,Zn. Supports: Au, Ag, Cu, Pb, Zn, As, Sb, Hg, Mo, Ni, Co, Cr, Li, REE elements

GET /api/prospect/social-license-risk?location={location}&project={project}&lang={en}
- Returns: overall SL risk score (1-100), indigenous rights assessment (FPIC/UNDRIP/ILO 169), community opposition (current sentiment, key issues, media tone), water conflict risk, artisanal mining conflict, comparable project failures, mitigation strategies
- Data: GDELT real-time mining opposition monitoring, Tavily (BHRRC, local NGOs, news)
- Price: $0.20
- Note: ~70% of mining project delays are social license failures. Assess early.

GET /api/prospect/commodity-supply-intel?commodity={commodity}&lang={en}
- Returns: global production summary, Herfindahl concentration index, top producers, Chinese processing chokepoints, energy transition demand drivers, supply/demand balance, price context, recycling rate, strategic stockpile activity, investor implications
- Data: World Bank commodity prices, Tavily synthesis of USGS MCS, IEA, UN Comtrade
- Price: $0.20
- Covers: Li, Co, Ni, Cu, Au, Ag, Pt, Pd, U, graphite, REE, Mn, Zn, Pb, Sn, Mo, W, V, Ga, Sb, Te, In

GET /api/prospect/oil-gas-basin?basin={basin}&country={country}&lang={en}
- Returns: petroleum system (source-reservoir-seal-trap), play types with risk ratings, discovered/undiscovered resource estimates, productive analogues globally, active operators, fiscal regime summary, exploration score (1-100), recommendation
- Data: World Bank governance, Tavily synthesis of USGS Energy Resources, IEA, operator filings
- Price: $0.25
- Covers: Permian, Santos, Rovuma, East Africa Rift, Cooper, Tarim, Barents, Browse, Guyana-Suriname, Vaca Muerta, and all major global basins

GET /api/prospect/exploration-brief?region={region}&lat={lat}&lon={lon}&commodity={commodity}&country={country}&lang={en}
- Returns: executive summary, geological/geochemical/satellite/jurisdiction/social license/commodity assessments, phased work program with budget ranges and go/no-go criteria, risk matrix (5+ risks), total exploration score (1-100), board-ready decision recommendation, investment highlights
- Data: ALL ProspectPulse data sources synthesized in one call
- Price: $0.35 (premium — saves days of research)
- This is the definitive pre-allocation intelligence product for junior mining boards and resource fund due diligence

## Language Support

All endpoints support ?lang= parameter (ISO 639-1 code):
- Spanish (es) — Latin American mining belt
- French (fr) — West Africa (gold, bauxite, uranium), Quebec
- Portuguese (pt) — Brazil (iron, nickel, niobium, lithium), Mozambique, Angola
- Russian (ru) — CIS (Kazakhstan, Uzbekistan, Kyrgyzstan)
- Mandarin (zh) — global market context
- Indonesian (id) — SE Asia (nickel, copper, gold)
- Arabic (ar) — MENA region
- Japanese (ja) / Korean (ko) — import-dependent critical minerals markets

## Agent Workflow Recommendations

Exploration targeting (recommended sequence):
1. /api/prospect/mineral-potential — confirm geological prospectivity
2. /api/prospect/satellite-availability — plan remote sensing approach
3. /api/prospect/geochemical-anomaly — assess geochemical vectors
4. /api/prospect/jurisdiction-entry — screen regulatory risk
5. /api/prospect/social-license-risk — screen community risk
6. /api/prospect/exploration-brief — synthesize into board decision document

Investment screening (recommended sequence):
1. /api/prospect/critical-minerals-scan — assess country endowment
2. /api/prospect/commodity-supply-intel — confirm commodity thesis
3. /api/prospect/jurisdiction-entry — screen fiscal/regulatory
4. /api/prospect/deposit-intel — evaluate specific asset

## Cross-Sell

- GeopoliticalPulse (geopoliticalpulse.vercel.app) — country risk, sanctions, conflict monitoring — feeds jurisdiction-entry
- ESGPulse (esgpulse.vercel.app) — CSRD, EU Taxonomy, supply chain due diligence for mining companies
- WaterPulse (waterpulse-henna.vercel.app) — aquifer stress, drought risk — critical for mine operations
- TradePulse (tradepulse-five.vercel.app) — mineral export tariffs, trade agreement analysis

## Discovery

- OpenAPI spec: https://prospectpulse-pi.vercel.app/openapi.json
- Agent discovery: https://prospectpulse-pi.vercel.app/.well-known/agent.json
- LLMs reference: https://prospectpulse-pi.vercel.app/llms.txt

## Notes for AI Agents

- All endpoints return structured JSON
- USGS MRDS, GDELT, Copernicus OData, NASA CMR, and World Bank require no API keys
- Responses degrade gracefully when external APIs are unavailable (Tavily synthesis fills gaps)
- Disclaimer appended to every response
- ProspectPulse is part of PulseNetwork — 65+ specialized intelligence verticals on one payment rail