# PRISM API

> The canonical data layer for financial assets. One API to resolve, normalize, and enrich any financial asset across crypto, equities, and DeFi.

## Base URL

https://api.prismapi.ai

## Authentication

All requests require an API key via the `X-API-Key` header.

Try without signup: GET https://api.prismapi.ai/auth/keys/instant returns a free key (5 req/min, 100/day). Use header X-API-Key.

Or sign up for higher limits: https://prismapi.ai/dashboard/keys

## Documentation Formats

- **Interactive UI (Scalar)**: https://api.prismapi.ai/docs
- **Markdown (for agents)**: https://api.prismapi.ai/docs/markdown
- **OpenAPI JSON**: https://api.prismapi.ai/docs/openapi
- **Endpoint List**: https://api.prismapi.ai/docs/endpoints.json
- **This file**: https://api.prismapi.ai/llms.txt

## API Overview

**Total Endpoints:** 244 across 15 categories

### By Category

- **Resolution** (18 endpoints): Resolve symbols, handle typos, contract addresses
- **Crypto** (49 endpoints): Prices, trending, OHLCV, metadata, DeFi
- **Stocks** (36 endpoints): Quotes, fundamentals, financials, screener
- **Predictions** (28 endpoints): Prediction markets, sports, odds
- **Macro** (16 endpoints): GDP, inflation, Fed rates, World Bank, BIS, economic calendar
- **World Monitoring** (15 endpoints): Earthquakes, wildfires, weather alerts, trade, vessels, outages
- **News & Calendar** (12 endpoints): Financial news, earnings calendar
- **Signals** (20 endpoints): Technical indicators, social sentiment
- **Developer** (13 endpoints): API keys, usage, health checks

## Common Patterns

### 1. Resolve an Asset
```
GET /resolve/{symbol}
Example: /resolve/BTC
Returns: Canonical asset ID, type, chain, metadata
```

### 2. Get Price Data
```
GET /crypto/price?symbol=BTC
GET /stocks/quote/{symbol}
GET /commodities/all
```

### 3. Get Portfolio Metrics
```
GET /crypto/portfolio/metrics?symbols=BTC,ETH,SOL
```

### 4. Check API Health
```
GET /health
Returns: Status, version, uptime
```

## Rate Limits

| Tier | QPS | Daily Limit | Header Shows Remaining |
|------|-----|-------------|------------------------|
| Agent (instant key) | 0.083 (5 req/min) | 100 | X-RateLimit-Remaining |
| Free | 1 | 1,000 | X-RateLimit-Remaining |
| Dev | 100 | 100,000 | X-RateLimit-Remaining |
| Pro | 300 | 1,000,000 | X-RateLimit-Remaining |

## Error Responses

All errors follow this format:
```json
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Symbol parameter is required",
    "details": {...},
    "request_id": "req_abc123"
  }
}
```

Common error codes:
- `VALIDATION_ERROR` (400): Invalid input
- `UNAUTHORIZED` (401): Missing or invalid API key
- `RATE_LIMIT_EXCEEDED` (429): Too many requests
- `NOT_FOUND` (404): Resource not found
- `INTERNAL_ERROR` (500): Server error

## MCP Integration

For AI agent integration via Model Context Protocol:

**Discovery:** https://api.prismapi.ai/.well-known/mcp.json
**NPM Package:** @strykr/prism-mcp
**Quick Start:** npx @strykr/prism-mcp

## SDK

**TypeScript SDK:** prism-finance-os
**Install:** npm install prism-finance-os
**Docs:** https://www.npmjs.com/package/prism-finance-os

## Support

- Dashboard: https://prismapi.ai/dashboard
- Contact: hello@strykr.ai
- Status: https://api.prismapi.ai/health