# NORTH7 — Financial Intelligence API

> AI-powered market data, risk assessment, and geopolitical intelligence for autonomous AI agents and market-monitoring bots.

## Overview
NORTH7 provides decision-ready market intelligence via REST API and MCP server. Unlike raw data APIs, every data point includes AI-generated confidence scores, reasoning, and context.

## Free Endpoints (no API key needed)
- GET https://north7.ai/v1/risk — Global risk index 0-100 with active crises
- GET https://north7.ai/v1/regime — Market regime: BULL / BEAR / SIDEWAYS / CRISIS
- GET https://north7.ai/v1/health — API status and data freshness

## Authenticated Endpoints (free API key, 1000 credits)
- GET /v1/signals/latest — Market data points: direction, confidence, reasoning (1 credit)
- GET /v1/signals/alpha — Daily equity analysis with directional assessment (2 credits)
- GET /v1/prices — Real-time prices for 80+ assets (1 credit)
- GET /v1/prices/history — 365-day price history (1 credit)
- GET /v1/analysis/{ticker} — Deep AI stock analysis with bullish/neutral/bearish assessment (5 credits)
- GET /v1/sector-radar — Sector rotation and breadth metrics (2 credits)
- GET /v1/commodities — 15 commodity risk scores and supply chain alerts (2 credits)
- GET /v1/commodities/{symbol} — Single commodity detail (2 credits)
- GET /v1/intraday — Intraday momentum scanner data (2 credits)
- GET /v1/intelligence/briefing — Geopolitical intelligence briefing (10 credits)
- GET /v1/portfolio/model — Model portfolio positions and performance metrics (10 credits)

## Authentication
Pass API key via X-API-Key header. Get a free key instantly:
POST https://north7.ai/v1/checkout/free?email=you@example.com&name=MyAgent

## Integration
- MCP Server: https://north7.ai/mcp (streamable-http transport)
- OpenAPI: https://north7.ai/v1/openapi.json
- A2A Agent Card: https://north7.ai/.well-known/agent.json
- AI Plugin: https://north7.ai/.well-known/ai-plugin.json
- Swagger UI: https://north7.ai/v1/docs

## Documentation
- Developer Portal: https://north7.ai/developers
- GitHub: https://github.com/a10102010/north7-agent-api