{"openapi":"3.1.0","info":{"title":"Provenance Data Grid","description":"Verified data for AI agents. 28 endpoints across entity intelligence, sanctions screening, healthcare providers, SEC filings, crypto prices, weather, and news. Multi-source verification with Ed25519 attestation. Pay per call via x402 (USDC on Base). US-based infrastructure.","contact":{"name":"New England Provenance LLC","url":"https://pdg.neprovenance.com/","email":"support@neprovenance.com"},"version":"0.1.0"},"paths":{"/price/crypto/{symbol}":{"get":{"tags":["market_data"],"summary":"Crypto price — USD price, 24h change, volume, market cap","description":"Get current price, 24h change, volume, and market cap for a cryptocurrency. Supports BTC, ETH, SOL, and 100+ coins.","operationId":"crypto_price_price_crypto__symbol__get","parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string","title":"Symbol"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/weather/{coordinates}":{"get":{"tags":["market_data"],"summary":"Weather — current conditions and 48h forecast for any coordinates","description":"Get weather for lat,lon coordinates. Example: /weather/42.36,-71.06","operationId":"weather_weather__coordinates__get","parameters":[{"name":"coordinates","in":"path","required":true,"schema":{"type":"string","title":"Coordinates"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/price/stock/{ticker}":{"get":{"tags":["market_data"],"summary":"Stock quote — price, day range, volume for any US-listed ticker","description":"Get current stock quote: price, day high/low, volume, previous close. All US-listed tickers.","operationId":"stock_price_price_stock__ticker__get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","title":"Ticker"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/weather-us/{coordinates}":{"get":{"tags":["market_data"],"summary":"US weather (NWS) — Weather.gov current conditions + 7-day forecast","description":"Get US weather from Weather.gov (NWS). Higher quality than Open-Meteo for US locations.\nIncludes current conditions from nearest station + 7-day forecast.\nExample: /weather-us/42.36,-71.06","operationId":"weather_us_weather_us__coordinates__get","parameters":[{"name":"coordinates","in":"path","required":true,"schema":{"type":"string","title":"Coordinates"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/price/crypto":{"get":{"tags":["market_data"],"summary":"Top cryptocurrencies — ranked by market cap with prices and 24h changes","description":"Get top cryptocurrencies by market cap with prices.","operationId":"crypto_list_price_crypto_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Number of coins to return","default":20,"title":"Limit"},"description":"Number of coins to return"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/news/search":{"get":{"tags":["market_data"],"summary":"News search — headlines by keyword from Google News","description":"Search news headlines via Google News RSS. Free, no API key.","operationId":"news_search_news_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","description":"Search query for news","title":"Q"},"description":"Search query for news"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":25,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/news/headlines":{"get":{"tags":["market_data"],"summary":"News headlines — top stories by topic (business, tech, health, sports)","description":"Get top news headlines by topic. Free, no API key.","operationId":"news_headlines_news_headlines_get","parameters":[{"name":"topic","in":"query","required":false,"schema":{"type":"string","description":"Topic: WORLD, NATION, BUSINESS, TECHNOLOGY, SCIENCE, HEALTH, SPORTS, ENTERTAINMENT","default":"BUSINESS","title":"Topic"},"description":"Topic: WORLD, NATION, BUSINESS, TECHNOLOGY, SCIENCE, HEALTH, SPORTS, ENTERTAINMENT"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":25,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/price/verified/crypto/{symbol}":{"get":{"tags":["market_data"],"summary":"Verified crypto price — 3-source consensus with Ed25519 attestation","description":"Multi-source verified crypto price. Queries 3 independent sources\n(CoinGecko, CoinCap, CryptoCompare), checks consensus within 0.5%,\nand returns a signed attestation.\n\nThe response includes each source's value, deviation from median,\nand a consensus flag. Signed with Fleet's Ed25519 key.\n\nUse /signing/public-key to get the verification key.","operationId":"verified_crypto_price_price_verified_crypto__symbol__get","parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string","title":"Symbol"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/web/extract":{"get":{"tags":["web_extract"],"summary":"Web extract — URL to clean LLM-ready markdown (Firefox Reader algorithm)","description":"Fetch a web page and extract its main content as clean LLM-ready markdown. Strips ads, navigation, scripts, and formatting noise. Same algorithm as Firefox Reader View.","operationId":"web_extract_web_extract_get","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","description":"URL to extract content from","title":"Url"},"description":"URL to extract content from"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/web/extract-batch":{"post":{"tags":["web_extract"],"summary":"Batch web extract — up to 5 URLs to markdown in parallel","description":"Extract clean markdown from up to 5 URLs in parallel. Returns content for each URL with error handling per-URL.","operationId":"web_extract_batch_web_extract_batch_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/web/search":{"get":{"tags":["web_extract"],"summary":"Web search — structured results via Brave Search","description":"Search the web and return structured results with titles, URLs, and descriptions. Powered by Brave Search.","operationId":"web_search_web_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","description":"Search query","title":"Q"},"description":"Search query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/chain/balance/{address}":{"get":{"tags":["chain_reads"],"summary":"Wallet balance — native ETH + ERC-20 tokens on Base/Ethereum/Arbitrum","description":"Get native + ERC-20 token balances for an address.","operationId":"chain_balance_chain_balance__address__get","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","title":"Address"}},{"name":"chain","in":"query","required":false,"schema":{"type":"string","description":"Chain: base, ethereum, arbitrum","default":"base","title":"Chain"},"description":"Chain: base, ethereum, arbitrum"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/chain/gas":{"get":{"tags":["chain_reads"],"summary":"Gas price — current base fee and priority fee on Base/Ethereum/Arbitrum","description":"Get current gas price and base fee.","operationId":"chain_gas_chain_gas_get","parameters":[{"name":"chain","in":"query","required":false,"schema":{"type":"string","description":"Chain: base, ethereum, arbitrum","default":"base","title":"Chain"},"description":"Chain: base, ethereum, arbitrum"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/chain/tx/{tx_hash}":{"get":{"tags":["chain_reads"],"summary":"Transaction lookup — details, receipt, and status by hash","description":"Get transaction details and receipt.","operationId":"chain_tx_chain_tx__tx_hash__get","parameters":[{"name":"tx_hash","in":"path","required":true,"schema":{"type":"string","title":"Tx Hash"}},{"name":"chain","in":"query","required":false,"schema":{"type":"string","description":"Chain: base, ethereum, arbitrum","default":"base","title":"Chain"},"description":"Chain: base, ethereum, arbitrum"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/entity/search":{"get":{"tags":["entity_verify"],"summary":"Business entity search — SEC, NPPES (9.89M), and 5 state SOS databases","description":"Search for business entities across multiple sources.\n\nSources: State SOS databases (NY, PA, CT, CO, OR), SEC EDGAR, NPPES.","operationId":"entity_search_entity_search_get","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string","description":"Business name to search","title":"Name"},"description":"Business name to search"},{"name":"state","in":"query","required":false,"schema":{"type":"string","description":"Two-letter state code (optional)","title":"State"},"description":"Two-letter state code (optional)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/entity/federal":{"get":{"tags":["entity_verify"],"summary":"Federal entity lookup — SAM.gov contractors with HUBZone/8(a)/WOSB certs","description":"Look up federal registrations: SAM.gov, set-aside certifications.","operationId":"entity_federal_entity_federal_get","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string","description":"Business name","title":"Name"},"description":"Business name"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/address/enrich":{"get":{"tags":["entity_verify"],"summary":"Address enrichment — property data + providers + business filings at address","description":"Full address enrichment: property data + nearby healthcare providers + business filings.\n\nQueries all available sources in parallel and returns a combined result.\nProperty data available for NE states (CT, MA, ME, NH, RI, VT).\nBusiness filings available for NY, PA, CT, CO, OR.\nHealthcare providers available for all 50 states.\nSEC EDGAR available for public companies nationwide.","operationId":"address_enrich_address_enrich_get","parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string","description":"Street address","title":"Address"},"description":"Street address"},{"name":"city","in":"query","required":true,"schema":{"type":"string","description":"City name","title":"City"},"description":"City name"},{"name":"state","in":"query","required":true,"schema":{"type":"string","description":"Two-letter state code","title":"State"},"description":"Two-letter state code"},{"name":"zip","in":"query","required":false,"schema":{"type":"string","description":"ZIP code (optional)","default":"","title":"Zip"},"description":"ZIP code (optional)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/provider/search":{"get":{"tags":["entity_verify"],"summary":"Healthcare provider search — 9.89M US providers by name, NPI, or specialty","description":"Search 9.89M US healthcare providers. Instant local lookup.\n\nSearch by name, NPI, location, or specialty. All 50 states + territories.\nData source: CMS NPPES (November 2026).","operationId":"provider_search_provider_search_get","parameters":[{"name":"name","in":"query","required":false,"schema":{"type":"string","description":"Provider or organization name","title":"Name"},"description":"Provider or organization name"},{"name":"npi","in":"query","required":false,"schema":{"type":"string","description":"NPI number (exact lookup)","title":"Npi"},"description":"NPI number (exact lookup)"},{"name":"city","in":"query","required":false,"schema":{"type":"string","description":"City","title":"City"},"description":"City"},{"name":"state","in":"query","required":false,"schema":{"type":"string","description":"Two-letter state code","title":"State"},"description":"Two-letter state code"},{"name":"zip","in":"query","required":false,"schema":{"type":"string","description":"ZIP code","title":"Zip"},"description":"ZIP code"},{"name":"taxonomy","in":"query","required":false,"schema":{"type":"string","description":"Taxonomy code (specialty)","title":"Taxonomy"},"description":"Taxonomy code (specialty)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/provider/at-address":{"get":{"tags":["entity_verify"],"summary":"Providers at address — all healthcare providers registered at a location","description":"Find all healthcare providers registered at a specific address.\n\nUseful for verifying if an address is a real medical facility, or for\ndetecting multiple suppliers at one location (Medicare compliance signal).","operationId":"providers_at_location_provider_at_address_get","parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string","description":"Street address","title":"Address"},"description":"Street address"},{"name":"city","in":"query","required":true,"schema":{"type":"string","description":"City","title":"City"},"description":"City"},{"name":"state","in":"query","required":true,"schema":{"type":"string","description":"Two-letter state code","title":"State"},"description":"Two-letter state code"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/company/{cik}":{"get":{"tags":["entity_verify"],"summary":"SEC company details — name, tickers, SIC code, recent filings by CIK","description":"Get SEC-registered company details: name, SIC code, tickers, addresses, recent filings.\n\nUse CIK number (e.g., 320193 for Apple). Get CIK from /entity/search results.","operationId":"company_detail_company__cik__get","parameters":[{"name":"cik","in":"path","required":true,"schema":{"type":"string","title":"Cik"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/company/{cik}/financials":{"get":{"tags":["entity_verify"],"summary":"SEC financials — revenue, net income, assets, EPS from XBRL filings","description":"Get key financial data for a public company from SEC XBRL filings.\n\nReturns latest annual revenue, net income, total assets, liabilities,\nequity, cash, debt, shares outstanding, and EPS. Pre-parsed by SEC.","operationId":"company_financials_company__cik__financials_get","parameters":[{"name":"cik","in":"path","required":true,"schema":{"type":"string","title":"Cik"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/sanctions/screen":{"get":{"tags":["entity_verify"],"summary":"OFAC sanctions screening — fuzzy match against 19,596 SDN entries","description":"Screen a name against the US OFAC Specially Designated Nationals (SDN) list.\n\nReturns exact and fuzzy matches. 19,596 entities in the database.\nUse for compliance checks before payments, vendor onboarding, or KYC.\n\nA match indicates potential similarity only — always verify with OFAC.","operationId":"sanctions_screen_sanctions_screen_get","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string","description":"Name to screen against OFAC SDN list","title":"Name"},"description":"Name to screen against OFAC SDN list"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/intelligence/entity":{"get":{"tags":["entity_verify","intelligence"],"summary":"Entity intelligence — cross-source report with confidence score and Ed25519 attestation","description":"Comprehensive entity intelligence report. The flagship endpoint.\n\nQueries ALL available sources in parallel and returns a unified report:\n- State SOS business registration (NY, PA, CT, CO, OR)\n- SEC EDGAR (public company match, filings)\n- NPPES (healthcare provider match, 9.89M records)\n- OFAC SDN sanctions screening (19,596 entries)\n- NE Provenance property data (if address in NE states)\n- Healthcare providers at address (if address provided)\n\nResponse includes:\n- All identifiers found (SOS IDs, CIK, NPI, ticker)\n- Registration details from every matching source\n- Sanctions screening result (clean/flagged)\n- Property data (if address in coverage area)\n- Confidence score (0.0-1.0) based on source authority, coverage, freshness\n- Ed25519 cryptographic attestation\n\nThis endpoint is priced higher than individual lookups because it\ndelivers cross-referenced intelligence, not raw data.","operationId":"entity_intelligence_intelligence_entity_get","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string","description":"Business or entity name","title":"Name"},"description":"Business or entity name"},{"name":"state","in":"query","required":false,"schema":{"type":"string","description":"Two-letter state code","title":"State"},"description":"Two-letter state code"},{"name":"address","in":"query","required":false,"schema":{"type":"string","description":"Street address (if known)","title":"Address"},"description":"Street address (if known)"},{"name":"city","in":"query","required":false,"schema":{"type":"string","description":"City (if known)","title":"City"},"description":"City (if known)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/market/search":{"get":{"tags":["prediction_markets"],"summary":"Prediction market search — find markets on Polymarket and Kalshi","description":"Search prediction markets across Kalshi and Polymarket.","operationId":"market_search_market_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","description":"Search query for prediction markets","title":"Q"},"description":"Search query for prediction markets"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/market/quote/{market_id}":{"get":{"tags":["prediction_markets"],"summary":"Prediction market quote — bid/ask/last price and volume","description":"Get current best bid/ask/last for a market.","operationId":"market_quote_market_quote__market_id__get","parameters":[{"name":"market_id","in":"path","required":true,"schema":{"type":"string","title":"Market Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/signing/public-key":{"get":{"tags":["system"],"summary":"Signing Public Key","description":"Public key for verifying Fleet response signatures.\n\nUse this to verify any response with an 'attestation' field.\nAlgorithm: Ed25519. Signature covers SHA-256 of canonical JSON payload.","operationId":"signing_public_key_signing_public_key_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/health":{"get":{"tags":["system"],"summary":"Health","description":"Service health with upstream source status. Returns 'ok' or 'degraded' with details on which sources are down.","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/metrics":{"get":{"tags":["system"],"summary":"Get Metrics","description":"Call counts, response times, revenue, cache stats, and unique payers per endpoint.","operationId":"get_metrics_metrics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}}},"components":{"schemas":{"BatchRequest":{"properties":{"urls":{"items":{"type":"string"},"type":"array","title":"Urls"}},"type":"object","required":["urls"],"title":"BatchRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"tags":[{"name":"intelligence","description":"Cross-source entity intelligence with confidence scoring and signing. Premium tier."},{"name":"entity_verify","description":"Business entity search, SEC filings, healthcare providers, sanctions screening."},{"name":"market_data","description":"Crypto prices (single and multi-source verified), stocks, weather, news."},{"name":"chain_reads","description":"Blockchain RPC: balances, gas prices, transaction details."},{"name":"prediction_markets","description":"Prediction market search and quotes (Polymarket, Kalshi)."},{"name":"web_extract","description":"Web page extraction to markdown and web search."},{"name":"system","description":"Health, metrics, signing public key."}]}