Financial intelligence for autonomous AI agents. Decision-ready signals, not raw data. Pay per call with USDC — no signup needed.
Test every endpoint live in your browser. Free endpoints work without a key — enter your API key to unlock all 12.
curl https://north7.ai/v1/risk
Click "Send Request" or pick an endpoint above...Try free endpoints (no key needed)
curl https://north7.ai/v1/risk # Risk index 0-100
curl https://north7.ai/v1/regime # BULL / BEAR / SIDEWAYS / CRISIS
curl https://north7.ai/v1/agent-context # Full market awareness (start here!)
curl https://north7.ai/v1/events # Structured events with impact scores
curl https://north7.ai/v1/impact # Event-to-asset impact mappingGet a free API key (1,000 credits) — instant, no payment
# With your key, access all 12 endpoints:
curl https://north7.ai/v1/signals/latest \
-H "X-API-Key: n7_live_your_key_here"Response with signals, confidence, and reasoning
{
"ok": true,
"data": {
"signals": [
{
"symbol": "MSFT",
"signal_type": "alpha_14d",
"direction": "long",
"confidence": 0.82,
"reason_en": "Strong cloud revenue growth, AI integration..."
}
],
"count": 29
},
"meta": {
"credits_used": 1,
"credits_remaining": 999,
"next": {
"endpoint": "/v1/analysis/MSFT",
"reason": "Deep-dive into this signal with full analysis"
}
}
}import requests
# No key needed for these:
risk = requests.get("https://north7.ai/v1/risk").json()
print(f"Risk: {risk['data']['value']}/100 ({risk['data']['status']})")
regime = requests.get("https://north7.ai/v1/regime").json()
print(f"Regime: {regime['data']['regime']}")
# With key for full access:
KEY = "n7_live_your_key_here"
headers = {"X-API-Key": KEY}
signals = requests.get("https://north7.ai/v1/signals/latest", headers=headers).json()
print(f"{signals['data']['count']} signals found")
for s in signals['data']['signals'][:3]:
print(f" {s['symbol']:8} {s['direction']:5} conf={s.get('confidence','?')}")Native integration for Claude and any MCP-compatible agent. 9 tools available instantly.
// claude_desktop_config.json
{
"mcpServers": {
"north7": {
"url": "https://north7.ai/mcp",
"transport": "streamable-http"
}
}
}Full A2A Agent Card with 9 skills. Any A2A-compatible agent auto-discovers NORTH7.
// Discovery:
GET /.well-known/agent.json
// 9 skills available:
// - market-risk-assessment
// - market-regime-detection
// - trading-signals
// - asset-prices
// - stock-analysis
// - intelligence-briefing
// - commodity-signals
// - sector-rotation
// - model-portfolioStandard REST API with OpenAPI 3.1 spec. Works with any HTTP client, SDK, or agent framework.
// Auto-generate clients:
GET /v1/openapi.json
// Interactive docs:
GET /v1/docs
// Agent instructions included
// in the OpenAPI descriptionNo signup, no API key. AI agents pay per request with USDC on Base. Convenience premium for autonomous agents.
// 1. Request without key:
curl north7.ai/v1/analysis/AAPL
// → 402 + PAYMENT-REQUIRED header
// 2. Agent reads requirements,
// signs USDC payment, retries
// with X-PAYMENT header → 200
// Discovery:
GET /.well-known/x402.json
// Price: $0.01 USDC per analysis
// Network: Base (eip155:8453)Pre-built Custom GPT with NORTH7 market intelligence. Users ask questions, GPT calls the API automatically.
// Create your own GPT:
// 1. Go to chat.openai.com/gpts/editor
// 2. Paste instructions from:
// north7.ai/developers
// (see OpenAPI spec below)
// 3. Add Action:
// OpenAPI URL: /v1/openapi.json
// Auth: API Key (X-API-Key)
// 4. Publish to GPT StoreDrop-in knowledge base for Claude Projects. Paste into Custom Instructions — Claude gets full API access.
// Setup in 30 seconds:
// 1. Go to claude.ai → Projects
// 2. Create new project
// 3. Custom Instructions → paste:
// north7.ai/developers
// (see OpenAPI spec below)
//
// Or use MCP for tool-use:
// claude_desktop_config.json
{
"mcpServers": {
"north7": {
"url": "https://north7.ai/mcp"
}
}
}Interactive docs: /v1/docs | OpenAPI spec: /v1/openapi.json | ReDoc: /v1/redoc
| Standard Financial APIs | NORTH7 |
|---|---|
| Raw price data (OHLCV) | AI-analyzed signals with confidence + reasoning |
| Requires API key to try | 3 free endpoints — try instantly, no signup |
| Designed for human developers | Agent-native: MCP, A2A, rich error hints |
| Single asset class | Multi-asset: stocks, commodities, forex, crypto |
| No context | Geopolitics + regime + risk integrated |
| Just data | Decision intelligence: "what to do" not just "what happened" |
| Static responses | "next" suggestions guide agents through workflows |
| Generic errors | Rich errors with hints agents can act on |
| No key required for payments | x402: agents pay per call with USDC — no signup needed |
| No proof of quality | Public track record — hit rate updated daily, auditable |
Start free. Buy credits instantly with PayPal.
Every response includes a next field suggesting the logical next endpoint to call.
"next": {
"endpoint": "/v1/analysis/MSFT",
"reason": "Deep-dive into this signal"
}Errors include hint fields that tell agents exactly what to do next.
{
"error": "Insufficient credits",
"hint": "Pay per call: retry without API key to receive a 402 with USDC payment requirements. Or contact support@north7.ai to add credits.",
"current_credits": 0,
"endpoint_cost": 1
}Every response includes headers so agents can self-throttle.
X-RateLimit-Limit: 300
X-RateLimit-Remaining: 299
X-Credits-Used: 1
X-Credits-Remaining: 49999The OpenAPI spec includes agent_instructions — a prompt that tells agents how to use NORTH7 optimally.
// In /v1/ response:
"agent_instructions": "Use /risk
and /regime FIRST to assess
market conditions..."