Anker Finance API

30+ Endpoints · REST + JSON · API-Key-Auth · Tier-basierte Rate-Limits

Quick Start

1. API-Key erstellen · 2. Header setzen · 3. Endpoint aufrufen.

curl -X POST https://anker.18.185.108.135.nip.io/api/v1/decide \
  -H "X-API-Key: ank_live_8a7c3d..." \
  -H "Content-Type: application/json" \
  -d '{"question":"Soll ich NVDA kaufen?","pfad":"aktiv"}'

Authentication

Alle /api/v1/* Endpoints brauchen API-Key. Zwei Wege:

Header	Format
`X-API-Key`	`ank_live_...`
`Authorization`	`Bearer ank_live_...`

Rate Limits (per Key)

Tier	req/min	~req/Tag	Preis
FREE	10	14k	€0/Mo
AUFBAU	60	86k	€9.99/Mo
AKTIV	300	432k	€19.99/Mo
EDGE	1500	2.16M	€49/Mo

Bei Limit-Überschreitung: HTTP 429 + reset_in_s im Body.

🪄 Decision Engine

POST/api/v1/decideAUFBAU+

AI orchestriert 1-6 von 19 Tools. Returns Verdict + Bullets + Next-Step.

Body: {"question": "Soll ich NVDA kaufen?", "pfad": "aktiv"}
Response: {
  "verdict": "WAIT",
  "headline": "NVDA BUY-Rating, aber Earnings-Timing kritisch",
  "bullets": ["...", "...", "..."],
  "tools_used": ["get_quantamental_rating", "get_news_digest", "..."],
  "elapsed_ms": 5430
}

🔍 Screener-Pro

GET/api/v1/screener/run/{template_id}AUFBAU+

Templates: lynch_tenbagger, buffett_quality, magic_formula, value_safe, low_vol_quality, high_growth_profitable

?limit=15&universe_size=100
Response: {"matches": [{"ticker":"AAPL","composite_score":82.6,...}], "elapsed_ms":...}

📊 Stock-Page Hub

GET/api/v1/stock/{ticker}AKTIV+

Single-Ticker Hub: Quote + 5-Faktor + 4 Scores + Bull/Bear-Cases + Agent-Signale.

?pfad=aufbau
Response: 25-field StockPageData incl. quant_factors, piotroski, levermann, bull/bear cases

🌐 Sektor-Trends

GET/api/sectors/trending/nowAUFBAU+

Top-N Long/Short-Themes mit Conviction + Top-Tickers.

GET/api/sectors/{theme_id}AUFBAU+

Tiefe Analyse + ranked Tickers + Catalysts/Risks.

🤖 Agents Marketplace

GET/api/agents/listFREE

POST/api/agents/{id}/runAKTIV+

18 Agents (10 themed + 8 personas). dry=true für no-track-record-log.

🎲 Options-Agent

GET/api/options/listFREE

58 Strategien Taxonomie, 28 mit Live-Builder.

GET/api/options/build/{strategy_id}/{ticker}AKTIV+

Concrete leg-construction mit Strikes + Greeks + Max-Loss/Gain + Breakeven + PoP.

POST/api/options/recommendAKTIV+

AI-Recommender via Goal + Skill + Ticker + IV-Regime.

GET/api/options/iv-rank/{ticker}AUFBAU+

RV-basierte IV-Metriken (rv_30d, iv_proxy, iv_rank, iv_regime).

₿ Crypto-Agent

GET/api/crypto/regimeFREE

BTC-DD-from-90d-High → bull/choppy/bear/stress.

GET/api/crypto/agent/{id}/runAKTIV+

5 Agents: crypto_btc_compounder, crypto_tsmom, crypto_dca, crypto_funding_arb, crypto_crash_hedge.

🛰️ AutoPilot (Self-Learning)

POST/api/autopilot/planAUFBAU+

Goal → Plan: berechnet Sparrate + baut Allokation aus 18 Agents + 1 ETF + Cash.

GET/api/autopilot/{user_id}/stateAUFBAU+

POST/api/autopilot/{user_id}/learnEDGE

Triggert Learning-Iteration aus Track-Record + Behavior + Regime.

🛑 Notbremse + Daily-Briefing

GET/api/notbremse/statusAUFBAU+

POST/api/briefing/cron-runEDGE

Cron-friendly. Iteriert alle subscribed users + sendet Telegram.

🏛️ Premium Council (Edge-only)

POST/api/council/conveneEDGE

5-Claude Multi-Analyst-Roundtable + Moderator. ~25-40s, 5× Token-Kosten.

📋 Position-Tracker

POST/api/positions/openAKTIV+

Setup → tracked Position mit BS-Reprice.

GET/api/positions/alertsAKTIV+

🧪 Strategy-Lab + Backtest

POST/api/lab/fullAKTIV+

NL-Thesis → Real Backtest + Bias-Detector. Returns full StrategyReport.

Status-Codes

Code	Bedeutung
`200`	OK
`401`	API-Key fehlt
`403`	API-Key ungültig oder revoked
`404`	Endpoint oder Resource nicht gefunden
`429`	Rate-Limit überschritten — siehe `reset_in_s`
`500`	Server-Fehler — body enthält `error` + `type`

MCP-Tools (für AI-Agents)

Alle Endpoints sind auch als MCP-Tools verfügbar — für AI-Agents wie Claude/GPT-Plugins. Konfiguration: https://anker.18.185.108.135.nip.io/.well-known/mcp.json (Phase 33.1).

Pricing & Stripe

Tier-Upgrade automatisch via Stripe-Webhook auf POST /api/stripe/webhook. Sandbox-Test: /dashboard?s=api-keys → "Neuer Key" → tier wählen.

SDK + OpenAPI-Schema

FastAPI-OpenAPI: /docs · /openapi.json

Python-SDK: pip install anker-finance-sdk (Phase 33.1)

Brauchst du höheren Rate-Limit oder Custom-Pricing?

Enterprise-Tier ab €499/Mo · White-Label · Dedicated-Support

Enterprise-Anfrage