Skip to content
REST API v2.0

Build with
sovereign AI.

The PolpAI API gives you 145 specialized agents, 410+ endpoints, and zero data extraction. Your API calls stay on your infrastructure. Ship faster. Stay sovereign.

Get API key → View endpoints
quickstart.py
# pip install polpai
import polpai

# Initialize client
client = polpai.Client(
    api_key="pk_live_..."
)

# Run Deal Hunter agent
result = client.agents.execute(
    agent="deal_hunter",
    task="Find MacBook Pro M4 deals",
    context={
        "budget": 2500,
        "currency": "CAD"
    }
)

print(result.recommendation)
# {price: 2249, savings: 251}
145
Agents
410+
Endpoints
<200ms
p95 latency
99.9%
Uptime SLA
API Reference

410+ endpoints. 8 tentacles.

Every agent is accessible via REST. JWT authenticated. Rate-limited per plan. Zero data retention after response.

POST/agents/execute

Run any of 145 agents by name. Pass context, task, and optional parameters. Returns structured result + confidence score.

GET/agents/list

List all available agents grouped by tentacle (T1–T8). Filter by domain, capability, or patent family.

POST/memory/store

Write to sovereign memory layer (L1–L5). AES-256-GCM encrypted. Stored on your infrastructure via BYOS.

GET/memory/recall

Recall from memory with semantic search. Supports cross-session context, decay scoring, L5 relational anchors.

POST/deals/scan

Trigger Deal Hunter (T1). Returns price data, discount authenticity score (0–1), retailer comparison table.

POST/gifts/recommend

Context-aware gift recommendations. Pass recipient profile, occasion, budget. Returns ranked suggestions with reasoning.

POST/pme/audit

Shadow AI compliance audit. Detects unauthorized AI usage, quantifies risk, auto-generates proposal. Value: $1,500+.

POST/quantum/audit

PQC security assessment (T5). Scans infrastructure for post-quantum readiness. Report value: $1,500–$3,000.

POST/finance/cashflow

Cash flow analysis and forecasting (T4). Multi-currency, FX risk, invoice automation, fiscal planning.

POST/chat

Conversational interface to the full agent team. Session-aware. Supports natural language agent routing.

GET/agents/metrics

Performance metrics: confidence score, execution time, fitness evolution, predict()/evolve() trajectory.

GET/health

System status, agent availability by tentacle, current API version. No authentication required.

Pricing

Scale with your usage.

No per-seat pricing. Pay for API calls. Upgrade or downgrade anytime.

Starter
$0
10,000 calls / mo
  • All 8 tentacles
  • Community support
  • 60 req/min
  • No data retention
Start free
Developer
$7.99 / mo
100,000 calls / mo
  • All tentacles + priority
  • Email support
  • 300 req/min
  • Webhook events
Start trial
Production
$29.99 / mo
1,000,000 calls / mo
  • All agents + BYOS
  • Priority support + SLA
  • 1,000 req/min
  • Dedicated endpoints
Contact us
Enterprise
Custom
Unlimited
  • Self-hosted deployment
  • Custom agent cluster
  • Custom SLA + MSA
  • PME pipeline included
Talk to us
SDKs

Your language. Our agents.

Official SDKs for the most popular languages. Community SDKs for the rest.

🐍

Python

Full async support. Pydantic models. FastAPI integration.

Available
🟨

JavaScript / TypeScript

Node.js + browser. React hooks. Zod validation.

Coming Q2 2026
🦀

Rust

Zero-overhead bindings. Tokio async. WASM-ready.

Coming Q3 2026
Security

OWASP compliant. Sovereign by default.

Every API call protected at the structural level — not just policy level. 55 patent families covering the security architecture.

🔐

JWT Authentication

Short-lived tokens with automatic rotation. No static API keys in production.

🛡

OWASP Top 10

Injection scan on every input. ASVS Level 2. Automated threat modeling per release.

📊

Rate Limiting

Per-key, per-IP, per-agent rate limits. DDoS protection via Cloudflare edge.

🔒

Zero Data Retention

API responses are ephemeral. No conversation stored server-side unless explicitly opted in.

🧪

Adversarial Compliance

95%+ ACT score across all agents. 50-scenario adversarial test suite per release.

🔑

Key Sovereignty (B27)

AES-256-GCM key vault. GitHub PAT rotation. Cloudflare token management. Zero-chat transmission.

PolpAI ecosystem