{ "openapi": "3.1.0", "info": { "title": "ProspectPulse API", "version": "1.0.0", "description": "Global mineral and resource exploration intelligence. USGS MRDS deposit inventory, geochemical anomaly analysis, satellite scene availability, jurisdiction entry-risk, social license risk, critical minerals country scans, commodity supply intelligence, and oil & gas basin analysis. All endpoints require x402 USDC micropayment on Base mainnet.", "contact": { "name": "The Aslan Group LLC", "email": "info@theaslangroupllc.com" }, "x-agent-network": "PulseNetwork", "x-payment-protocol": "x402", "x-payment-asset": "USDC on Base (eip155:8453)" }, "servers": [{ "url": "https://prospectpulse-pi.vercel.app", "description": "Production" }], "components": { "securitySchemes": { "x402": { "type": "apiKey", "in": "header", "name": "PAYMENT-SIGNATURE", "description": "x402 payment signature. Send a GET without this header to receive a 402 with payment requirements. Sign and retry with PAYMENT-SIGNATURE header." } } }, "security": [{ "x402": [] }], "paths": { "/api/prospect/mineral-potential": { "get": { "operationId": "mineralPotential", "summary": "Mineral prospectivity assessment", "description": "AI-powered mineral prospectivity assessment for any global region. Queries USGS MRDS (300K+ deposits), geochemical database, and geological literature to evaluate exploration potential by commodity and deposit type. Covers all continents, all commodities.", "x-agent-use-case": "on-demand", "x-agent-chaining": "Use before jurisdiction-entry and social-license-risk. Chain with satellite-availability for remote sensing targets. Feeds exploration-brief.", "x-price-usd": "0.25", "parameters": [ { "name": "region", "in": "query", "schema": { "type": "string" }, "description": "Named geological region | Carlin Trend Nevada | Atacama Desert | Abitibi Greenstone Belt | Zambia Copper Belt | Pilbara WA" }, { "name": "lat", "in": "query", "schema": { "type": "number" }, "description": "Latitude (decimal degrees)" }, { "name": "lon", "in": "query", "schema": { "type": "number" }, "description": "Longitude (decimal degrees)" }, { "name": "commodity", "in": "query", "schema": { "type": "string" }, "description": "Target commodity | gold | copper | lithium | nickel | cobalt | REE | uranium | silver | zinc" }, { "name": "lang", "in": "query", "schema": { "type": "string", "default": "en" }, "description": "Response language (ISO 639-1) | en | es | fr | pt | ru | zh | id | ar" } ], "responses": { "200": { "description": "Mineral prospectivity assessment", "content": { "application/json": { "schema": { "type": "object", "properties": { "target_area": { "type": "string" }, "prospectivity_score": { "type": "number" }, "prospectivity_tier": { "type": "string" }, "geological_setting": { "type": "string" }, "deposit_systems": { "type": "array" }, "known_mineralization": { "type": "object" }, "analogous_districts": { "type": "array" }, "recommended_techniques": { "type": "array" }, "analyst_summary": { "type": "string" } } } } } }, "402": { "description": "Payment required — attach PAYMENT-SIGNATURE header" } }, "security": [{ "x402": [] }] } }, "/api/prospect/deposit-intel": { "get": { "operationId": "depositIntel", "summary": "Mineral deposit intelligence", "description": "Deep intelligence on any named mineral deposit or mine globally. USGS MRDS records plus exploration news synthesis: resource context, development stage, ownership, comparable deposits, recent activity.", "x-agent-use-case": "on-demand", "x-agent-chaining": "Chain with commodity-supply-intel for market context. Use jurisdiction-entry for regulatory backdrop.", "x-price-usd": "0.20", "parameters": [ { "name": "deposit", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Deposit or mine name | Escondida | Oyu Tolgoi | Kibali | Grasberg | Olympic Dam | Thacker Pass | Jadar | Cobre Panama" }, { "name": "lang", "in": "query", "schema": { "type": "string", "default": "en" }, "description": "Response language (ISO 639-1)" } ], "responses": { "200": { "description": "Deposit intelligence report" }, "402": { "description": "Payment required" } }, "security": [{ "x402": [] }] } }, "/api/prospect/critical-minerals-scan": { "get": { "operationId": "criticalMineralsScan", "summary": "Critical minerals country endowment scan", "description": "Country or region endowment in all critical minerals: lithium, cobalt, nickel, REE, graphite, copper, PGE, uranium. Supply chain geopolitics, strategic significance, development status, export restriction risk. For sovereign wealth funds, procurement agencies, and critical mineral investors.", "x-agent-use-case": "on-demand", "x-agent-chaining": "Chain with jurisdiction-entry for investment decision. Use with commodity-supply-intel for market context.", "x-price-usd": "0.25", "parameters": [ { "name": "country", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Country or region | DRC | Chile | Indonesia | Australia | Greenland | Kazakhstan | Philippines | Argentina | Canada | Zambia | Zimbabwe | Guinea | Papua New Guinea | Brazil" }, { "name": "lang", "in": "query", "schema": { "type": "string", "default": "en" }, "description": "Response language (ISO 639-1) | en | es | fr | pt | ru | zh | id | ar | ja | ko" } ], "responses": { "200": { "description": "Critical minerals endowment scan" }, "402": { "description": "Payment required" } }, "security": [{ "x402": [] }] } }, "/api/prospect/jurisdiction-entry": { "get": { "operationId": "jurisdictionEntry", "summary": "Exploration jurisdiction entry-risk assessment", "description": "Full entry-risk assessment for mineral exploration in any country: mining code, license acquisition, royalties, corporate tax, local content, environmental permitting, political stability, security conditions. World Bank governance scores integrated. 80+ countries.", "x-agent-use-case": "on-demand", "x-agent-chaining": "Use after mineral-potential confirms geological prospectivity. Chain with social-license-risk for complete project risk picture.", "x-price-usd": "0.25", "parameters": [ { "name": "country", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Country | Canada | Australia | Chile | Peru | DRC | Ghana | Tanzania | Kazakhstan | Philippines | Greenland | Ecuador | Bolivia | Zambia | Namibia | Mongolia | Brazil | Mexico | Colombia" }, { "name": "commodity", "in": "query", "schema": { "type": "string" }, "description": "Target commodity for fiscal specifics | gold | copper | lithium | nickel | cobalt | uranium" }, { "name": "lang", "in": "query", "schema": { "type": "string", "default": "en" }, "description": "Response language (ISO 639-1) | en | es | fr | pt | ru | zh | ar" } ], "responses": { "200": { "description": "Jurisdiction entry-risk assessment" }, "402": { "description": "Payment required" } }, "security": [{ "x402": [] }] } }, "/api/prospect/satellite-availability": { "get": { "operationId": "satelliteAvailability", "summary": "Free satellite scene availability + remote sensing guide", "description": "Sentinel-1 SAR, Sentinel-2 optical, ASTER thermal, and Landsat scene availability for any coordinates, plus a practical geological remote sensing guide: alteration mapping, structural geology, regolith characterization — all using free tools.", "x-agent-use-case": "on-demand", "x-agent-chaining": "Use after mineral-potential to guide remote sensing follow-up. Chain with geochemical-anomaly for integrated targeting.", "x-price-usd": "0.10", "parameters": [ { "name": "lat", "in": "query", "required": true, "schema": { "type": "number" }, "description": "Latitude (decimal degrees) | -23.8 | 39.5 | -0.5 | 60.2" }, { "name": "lon", "in": "query", "required": true, "schema": { "type": "number" }, "description": "Longitude (decimal degrees) | 119.4 | -117.3 | 28.6 | 25.4" }, { "name": "commodity", "in": "query", "schema": { "type": "string" }, "description": "Target commodity for alteration guidance | gold | copper | lithium | nickel | REE" }, { "name": "lang", "in": "query", "schema": { "type": "string", "default": "en" }, "description": "Response language (ISO 639-1)" } ], "responses": { "200": { "description": "Satellite availability and remote sensing guide" }, "402": { "description": "Payment required" } }, "security": [{ "x402": [] }] } }, "/api/prospect/geochemical-anomaly": { "get": { "operationId": "geochemicalAnomaly", "summary": "USGS geochemical anomaly characterization", "description": "USGS National Geochemical Database query + AI interpretation of element anomalies, pathfinder suites, and deposit-type signatures. Supports all exploration elements: Au, Cu, As, Pb, Zn, Mo, Ni, Co, Li, REE, Sb, Hg, Bi.", "x-agent-use-case": "on-demand", "x-agent-chaining": "Combine with satellite-availability for integrated target vector. Feed results into exploration-brief.", "x-price-usd": "0.15", "parameters": [ { "name": "region", "in": "query", "schema": { "type": "string" }, "description": "Named region | Carlin Trend Nevada | Basin and Range | Great Basin" }, { "name": "lat", "in": "query", "schema": { "type": "number" }, "description": "Latitude (decimal degrees)" }, { "name": "lon", "in": "query", "schema": { "type": "number" }, "description": "Longitude (decimal degrees)" }, { "name": "elements", "in": "query", "schema": { "type": "string", "default": "Au,Cu,As,Pb,Zn" }, "description": "Comma-separated elements | Au,As,Sb | Cu,Mo,Au | Ni,Co,Cr | Li,Cs,Rb" }, { "name": "lang", "in": "query", "schema": { "type": "string", "default": "en" }, "description": "Response language (ISO 639-1)" } ], "responses": { "200": { "description": "Geochemical anomaly characterization" }, "402": { "description": "Payment required" } }, "security": [{ "x402": [] }] } }, "/api/prospect/social-license-risk": { "get": { "operationId": "socialLicenseRisk", "summary": "Social license risk assessment", "description": "Community opposition intelligence, indigenous rights risk (FPIC, UNDRIP, ILO 169), water conflict assessment, artisanal mining conflicts, and ESG red flags. GDELT real-time media monitoring + open-source intelligence. Comparable project failures included.", "x-agent-use-case": "on-demand", "x-agent-chaining": "Use with jurisdiction-entry for complete risk picture. High social license risk often overrides positive geology.", "x-price-usd": "0.20", "parameters": [ { "name": "location", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Location | Peru Cajamarca | Pebble Alaska | West Papua Indonesia | Ring of Fire Ontario | Northern BC Canada | Limpopo South Africa | Oaxaca Mexico" }, { "name": "project", "in": "query", "schema": { "type": "string" }, "description": "Optional project name | Conga Mine | Pebble Mine | Ajax Mine | New Prosperity" }, { "name": "lang", "in": "query", "schema": { "type": "string", "default": "en" }, "description": "Response language (ISO 639-1) | en | es | fr | pt | id | tl" } ], "responses": { "200": { "description": "Social license risk assessment" }, "402": { "description": "Payment required" } }, "security": [{ "x402": [] }] } }, "/api/prospect/commodity-supply-intel": { "get": { "operationId": "commoditySupplyIntel", "summary": "Commodity supply/demand intelligence", "description": "Global supply and demand for any mining commodity: production concentration (Herfindahl index), top producers, energy transition demand, Chinese processing chokepoints, price context, supply/demand balance, recycling rates, strategic stockpile activity. 30+ commodities.", "x-agent-use-case": "on-demand", "x-agent-chaining": "Use before exploration budget allocation. Chain with critical-minerals-scan for country supply context.", "x-price-usd": "0.20", "parameters": [ { "name": "commodity", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Mining commodity | lithium | cobalt | nickel | copper | gold | silver | uranium | graphite | REE | platinum | palladium | manganese | zinc | lead | tin | molybdenum | tungsten | vanadium | gallium | antimony | tellurium | indium" }, { "name": "lang", "in": "query", "schema": { "type": "string", "default": "en" }, "description": "Response language (ISO 639-1) | en | es | fr | pt | zh | ja | ko | de | ar | ru" } ], "responses": { "200": { "description": "Commodity supply intelligence" }, "402": { "description": "Payment required" } }, "security": [{ "x402": [] }] } }, "/api/prospect/oil-gas-basin": { "get": { "operationId": "oilGasBasin", "summary": "Oil & gas basin analysis", "description": "Petroleum system analysis: source-reservoir-seal-trap architecture, play types, discovered and undiscovered resource estimates, exploration maturity, active operators, fiscal regime. Covers frontier to mature basins globally.", "x-agent-use-case": "on-demand", "x-agent-chaining": "Chain with jurisdiction-entry for fiscal context. Use critical-minerals-scan if basin also has mineral potential.", "x-price-usd": "0.25", "parameters": [ { "name": "basin", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Basin or region | Permian Basin | Santos Basin Brazil | Rovuma Basin | East African Rift | Cooper Basin Australia | Tarim Basin | Barents Sea | Guyana-Suriname | Browse Basin | Namibe Basin Angola | Vaca Muerta Argentina" }, { "name": "country", "in": "query", "schema": { "type": "string" }, "description": "Country for governance context | USA | Brazil | Mozambique | Australia | China | Norway | Guyana | Argentina" }, { "name": "lang", "in": "query", "schema": { "type": "string", "default": "en" }, "description": "Response language (ISO 639-1) | en | es | fr | pt | ru | zh | ar | id" } ], "responses": { "200": { "description": "Oil & gas basin analysis" }, "402": { "description": "Payment required" } }, "security": [{ "x402": [] }] } }, "/api/prospect/exploration-brief": { "get": { "operationId": "explorationBrief", "summary": "Comprehensive exploration target brief (premium)", "description": "Board-ready exploration brief synthesizing all ProspectPulse intelligence: USGS MRDS geology, geochemistry, Copernicus/NASA satellite availability, World Bank jurisdiction governance, GDELT social license risk, and commodity supply/demand. Structured go/no-go recommendation with phased work program, budget ranges, risk matrix, and investment highlights. The definitive pre-allocation intelligence product for junior mining boards and resource fund due diligence.", "x-agent-use-case": "on-demand", "x-agent-chaining": "Terminal endpoint — synthesizes all ProspectPulse data sources. Run last in the exploration workflow after individual endpoint queries.", "x-price-usd": "0.35", "parameters": [ { "name": "region", "in": "query", "schema": { "type": "string" }, "description": "Target region | Atacama lithium triangle | Northern Ontario gold | West African gold belt | Copper Belt Zambia-DRC | Nevada gold province" }, { "name": "lat", "in": "query", "schema": { "type": "number" }, "description": "Latitude (decimal degrees)" }, { "name": "lon", "in": "query", "schema": { "type": "number" }, "description": "Longitude (decimal degrees)" }, { "name": "commodity", "in": "query", "schema": { "type": "string", "default": "gold" }, "description": "Primary commodity | gold | copper | lithium | nickel | cobalt | REE | uranium | silver" }, { "name": "country", "in": "query", "schema": { "type": "string" }, "description": "Country for jurisdiction and governance | Chile | Canada | Ghana | Australia | DRC | Peru | Kazakhstan | Mongolia" }, { "name": "lang", "in": "query", "schema": { "type": "string", "default": "en" }, "description": "Response language (ISO 639-1) | en | es | fr | pt | ru | zh | ar" } ], "responses": { "200": { "description": "Comprehensive exploration brief", "content": { "application/json": { "schema": { "type": "object", "properties": { "executive_summary": { "type": "string" }, "geological_assessment": { "type": "object" }, "jurisdiction_assessment": { "type": "object" }, "social_license_assessment": { "type": "object" }, "recommended_work_program": { "type": "array" }, "risk_matrix": { "type": "array" }, "total_exploration_score": { "type": "number" }, "decision_recommendation": { "type": "string" }, "investment_highlights": { "type": "array" } } } } } }, "402": { "description": "Payment required" } }, "security": [{ "x402": [] }] } } } }