NORTH7 Agent API

Try It Now — No API Key

These endpoints are completely free. Click to see live data:

Live API Response

Click a button above to see live API data...

# These work right now, no signup needed:
curl https://north7.ai/v1/risk
curl https://north7.ai/v1/regime
curl https://north7.ai/v1/health

Quick Start

1

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

2

Get 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"

3

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"
    }
  }
}

Python

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','?')}")

AI Agent Integration

MCP (Model Context Protocol)

Anthropic Standard

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"
    }
  }
}

A2A (Agent-to-Agent)

Google Standard

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-portfolio

OpenAPI / REST

Universal

Standard 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 description

ChatGPT Plugin

OpenAI Standard

AI plugin manifest for GPT and compatible agents.

// Plugin discovery:
GET /.well-known/ai-plugin.json

// Includes model-optimized
// descriptions for tool selection

Endpoints

Free — No API Key Required

GET/v1/riskGlobal risk index 0-100 + crises + regionsFREE

GET/v1/regimeBULL / BEAR / SIDEWAYS / CRISISFREE

GET/v1/healthAPI health + data freshness + integration URLsFREE

Signals

GET/v1/signals/latestAll signals from 6 AI sources1 credit

GET/v1/signals/alphaAlpha Daily — highest conviction2 credits

GET/v1/commodities15 raw materials scoring2 credits

GET/v1/intradayIntraday momentum scanner2 credits

Market Data

GET/v1/pricesReal-time prices (80+ assets)1 credit

GET/v1/prices/history365-day price history1 credit

Analysis & Intelligence

GET/v1/analysis/{ticker}Deep AI stock analysis5 credits

GET/v1/sector-radarSector rotation radar2 credits

GET/v1/intelligence/briefingDaily geopolitical briefing10 credits

GET/v1/portfolio/modelModel portfolio + performance10 credits

Interactive docs: /v1/docs | OpenAPI spec: /v1/openapi.json | ReDoc: /v1/redoc

Why Agents Choose NORTH7

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

Pricing

Start free. Buy credits instantly with PayPal.

Free

0 EUR

3 endpoints, no key needed
Risk, Regime, Health
1,000 credits with key
10 requests/min

Starter

5 EUR

50,000 credits
All 12 endpoints
60 requests/min
Email support

Contact for Key

Pro

25 EUR

500,000 credits
All 12 endpoints
300 requests/min
Priority support

Contact for Key

Enterprise

Custom

Unlimited credits
1,000 requests/min
Custom endpoints
Dedicated support

Built for Agents

Workflow Guidance

Every response includes a next field suggesting the logical next endpoint to call.

"next": {
  "endpoint": "/v1/analysis/MSFT",
  "reason": "Deep-dive into this signal"
}

Rich Error Messages

Errors include hint fields that tell agents exactly what to do next.

{
  "error": "Insufficient credits",
  "hint": "Contact support@north7.ai",
  "current_credits": 0,
  "endpoint_cost": 1
}

Rate Limit Headers

Every response includes headers so agents can self-throttle.

X-RateLimit-Limit: 300
X-RateLimit-Remaining: 299
X-Credits-Used: 1
X-Credits-Remaining: 49999

Agent Instructions

The 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..."