Docs / Provider Plan

PrismAPI Integration Plan

How Prism feeds enterprise, citizen, government, macro, market, and world-risk intelligence.

PrismAPI Integration Plan for The Architect / GDCOS

Production docs studied: https://api.prismapi.ai/docs
OpenAPI version observed: 4.13.0
Base URL: https://api.prismapi.ai

What PrismAPI Does

PrismAPI is an AI/agent-native data API for structured financial, market, macro, prediction, sports, DeFi, on-chain, social, and world-monitoring data. It exposes LLM-safe JSON responses and agent helper endpoints such as /agent/endpoints, /agent/context, and /agent/schemas.

Authentication is optional by default. It supports instant free API keys, managed keys, usage tracking, and X-API-Key authentication when a key is configured.

Best Fit for Our Platform

PrismAPI should complement the platform's evidence model as a structured source provider. It should not replace legal registries, Didit KYC, eID, or owner-submitted official documents.

Enterprise Enrichment

Useful endpoints:

  • /stocks/{symbol}/profile - company profile, sector, industry, identifiers such as ISIN, CUSIP, CIK.
  • /stocks/{symbol}/quote - current price/market data.
  • /stocks/{symbol}/fundamentals - valuation, profitability, debt, liquidity, growth, dividends, analyst metrics.
  • /stocks/{symbol}/financials - income, balance sheet, and cash-flow statements.
  • /stocks/{symbol}/filings - SEC filings and document links.
  • /stocks/{symbol}/insiders - insider trading activity.
  • /stocks/{symbol}/institutional - institutional holders.
  • /stocks/{symbol}/peers - peer companies.
  • /risk/{symbol}/metrics and /risk/{symbol}/var - volatility, Sharpe/Sortino, drawdown, beta, VaR.
  • /valuation/{symbol}/ratios and /valuation/{symbol}/dcf - valuation ratios and simplified DCF.
  • /news/stocks?symbol= - company news context.

Platform use:

  • Add non-official source rows as market_data_provider.
  • Convert outputs into score facts for market, financial, governance, transparency, and risk components.
  • Use CIK/ISIN/CUSIP to cross-link official SEC/registry evidence.
  • Use news, filings, insider activity, and fundamentals as review triggers rather than final truth.

Citizen Context Enrichment

Useful endpoints:

  • /macro/inflation, /macro/unemployment, /macro/jobless-claims, /macro/housing, /macro/consumer.
  • /macro/world-bank?country=&indicator=&date= for country-level labor, GDP, population, poverty, education, and governance indicators.
  • /calendar/economic for upcoming macro events.

Platform use:

  • Use only as jurisdiction-level context.
  • Do not infer private citizen wealth, debt, employability, or personal credit from macro context alone.
  • Feed cost-of-living, labor-market, and macro-stress context into confidence/explanation fields.

Government and Gov Metrics

Useful endpoints:

  • /macro/summary - consolidated fed rate, inflation, treasury yields, unemployment, GDP, M2.
  • /macro/world-bank - country time-series by official World Bank code.
  • /world/trade - WTO trade time-series payloads.
  • /world/government-spending - USA Spending awards.
  • /calendar/economic - major policy/economic events.
  • /macro/bis - BIS policy rates.

Platform use:

  • Build government dashboards for macro stability, public spending, trade dependency, labor stress, and inflation context.
  • Store as score sources/facts with source URL and date window.
  • Use null/sparse payloads as source freshness issues, not fabricated facts.

World Risk and Operations

Useful endpoints:

  • /world/earthquakes, /world/natural-events, /world/wildfires, /world/weather-alerts.
  • /world/unrest, /world/internet-outages, /world/service-status.
  • /world/trade, /world/aircraft, /world/aviation-status, /world/maritime-safety, /world/vessels.

Platform use:

  • Enterprise supply-chain and operational risk.
  • Government emergency status dashboards.
  • Public-monitoring feed on /monitor.
  • Grant/procurement delay context when disasters, outages, unrest, or transport disruption affect execution.

Prediction and Sentiment Signals

Useful endpoints:

  • /predictions/markets, /predictions/search, /predictions/trending, /predictions/arbitrage.
  • /market/fear-greed, /news/crypto, /news/stocks, /social/{symbol}/sentiment, /social/trending.

Platform use:

  • Forward-looking risk context, public sentiment, and market-implied probabilities.
  • Treat as weak/confidence-limited signal unless corroborated by official evidence.

Deployed Agent Tools

  • prism_api_catalog
  • prism_enterprise_market_snapshot
  • enrich_enterprise_with_prism
  • prism_macro_government_context
  • prism_citizen_economic_context
  • prism_world_risk_context

Governance Rules

  • PrismAPI data is provider context, not official identity evidence.
  • Persisted Prism data must go through owner/editor/admin-gated enterprise source APIs.
  • Citizen use must remain jurisdictional/contextual unless the user explicitly consents to connecting private financial records through open banking or similar regulated sources.
  • Score formulas must disclose when PrismAPI facts are used and which endpoint produced them.