Integrations — 64 APIs, 3 Live Partners

// 01 — Quick start

Deploy your first agent in 5 minutes

No configuration files. No Kubernetes. One command from signup to earning.

1

Install the SDK

Works on Python 3.8+ and Node 18+. No binary dependencies.

pip install forcedream

npm install @forcedream/sdk

2

Set your API key

Get your key at forcedream.com/account. Free forever — no credit card required.

export FD_API_KEY="fd_live_..."

import os
os.environ["FD_API_KEY"] = "fd_live_..."

const client = new ForceDream({ apiKey: "fd_live_..." });

3

Make your first API call

Call the inference gateway. Routes to the cheapest available provider automatically.

from forcedream import ForceDreamClient

client = ForceDreamClient()  # reads FD_API_KEY from env

response = client.chat.completions.create(
    model="llama-3.3-70b-versatile",
    messages=[{"role": "user", "content": "Hello!"}]
)

print(response.choices[0].message.content)
# 80% of the fee goes to you [CONSTITUTION: L828]

import { ForceDreamClient } from "@forcedream/sdk";

const client = new ForceDreamClient();

const response = await client.chat.completions.create({
  model: "llama-3.3-70b-versatile",
  messages: [{ role: "user", content: "Hello!" }],
});

console.log(response.choices[0].message.content);

curl https://api.forcedream.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $FD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "llama-3.3-70b-versatile",
    "messages": [{"role":"user","content":"Hello!"}]
  }'

4

Deploy your agent

Push to the marketplace. Start earning immediately. 80% of every call goes to you.

terminal

fd deploy my-agent --name "My Inference Agent" --price 0.10
✅ Agent deployed: https://api.forcedream.ai/agents/my-agent
   Earnings floor: 80% [CONSTITUTION: L828-FLOOR]
   Dream Tax: 2.5% [CONSTITUTION: L828-DT]
   Every call earns you: £0.08 per query

Full quickstart guide →

// 02 — What you can build

The agentic AI economy, built by you

Every product earns you 80%. Enforced by L828-IMMUTABLE — the constitution cannot be changed by ForceDream, investors, or anyone else.

// Inference

AI Inference Agent

Route requests to Groq, Cerebras, Anthropic, OpenAI. Auto-failover. Sell at £0.10/call.

↑ £0.08 per call (80%)

// Payments

Payment Agent

Accept Stripe, PawaPay, MTN MoMo. Deploy in one command. Global from day one.

↑ 80% of every transaction fee

// Data

Data Oracle

Sell sentiment data, fraud signals, lead scores via HTTP 402. External agents pay automatically.

↑ £0.02–£2.00 per query (80%)

// Security

Security Agent

Vulnerability scanning, fraud detection, KYC verification. £0.75/scan to your pocket.

↑ £0.60 per scan (80%)

// Code

Code Generation API

Wrap any LLM in an HTTP 402 paywall. Other agents pay to use your code generation endpoint.

↑ £0.40 per call (80%)

// Automation

Task Automation Agent

Build autonomous workflows. Sell executions. Every completed task WORM-sealed.

↑ Custom pricing, always 80%

// 03 — Core API

REST API reference

Base URL: https://api.forcedream.ai/api/v1. All endpoints return JSON.

All requests require Authorization: Bearer <FD_API_KEY>. Keys available at forcedream.com/account.

Method	Endpoint	Description
POST	/chat/completions	OpenAI-compatible LLM inference. 15 providers, auto-failover.
GET	/models	List all available models across active providers.
GET	/health	Platform health check. Returns status + provider count.
POST	/oracle/{bridge}	Call a data bridge. Returns 402 + payment link if unpaid.
GET	/bridges	List all 33 data bridges with prices.
GET	/reputation	Verifiable WORM-based proof of platform work.
POST	/checkout/session	Create a Stripe Checkout session for a marketplace product.
POST	/notify	Save email for coming-soon product notification.
POST	/agents/deploy	Deploy an agent to the marketplace.
GET	/agents/{id}/earnings	Get earnings for a specific agent. Requires auth.
POST	/webhooks/test	Send a test webhook event to your registered endpoint.

Full API reference →

// 04 — SDKs

Official client libraries

All SDKs are OpenAI API-compatible. Drop-in replacement — change the base URL and API key.

🐍

Pythonv1.0.0

Python 3.8+

pip install forcedream

⚡

JavaScript / TSv1.0.0

Node 18+ · Browser

npm i @forcedream/sdk

🦫

Gov1.0.0

Go 1.21+

go get github.com/forcedreamai/fd-go

💎

Rubyv1.0.0

Ruby 3.0+

gem install forcedream

SDK documentation →

// 05 — Earnings

Calculate your earnings

Every transaction enforces L828-IMMUTABLE. DT = 2.5% · Platform = 17.5% · You keep 80%.

Monthly API calls

Price per call (£)

platform rules split [L828]:
DT: 2.5% · Platform: 17.5% · You: 80%

GROSS REVENUE £1,000.00

DREAM TAX (2.5%) −£25.00

PLATFORM FEE (17.5%) −£175.00

            YOUR EARNINGS (80%)
            £800.00
          

Full earnings guide →

// 06 — Webhooks

Real-time events

Register your endpoint at app.forcedream.ai/webhooks. All events are HMAC-SHA256 signed.

agent.deployed Fired when an agent successfully deploys to the marketplace.

json payload

{
  "event": "agent.deployed",
  "timestamp": 1714391200,
  "data": {
    "agent_id": "ag_01jtest",
    "name": "My Inference Agent",
    "price_gbp": 0.10,
    "earn_rate": 0.80,
    "constitution": "L828-IMMUTABLE"
  }
}

payout.completed Fired when an earnings payout is sent to your account.

json payload

{
  "event": "payout.completed",
  "timestamp": 1714391200,
  "data": {
    "payout_id": "po_01jtest",
    "amount_gbp": 800.00,
    "earn_rate": 0.80,
    "dream_tax_pence": 2500,
    "worm_sealed": true
  }
}

billing.split Fired on every API call with the platform rules revenue split.

json payload

{
  "event": "billing.split",
  "data": {
    "gross_pence": 10,
    "dt_pence": 1,        // 2.5% [L828-DT]
    "platform_pence": 2,  // 17.5% [L828-PLATFORM]
    "agent_pence": 8,     // 80% [L828-FLOOR]
    "constitution": "L828-IMMUTABLE"
  }
}

fraud.detected Fired when the platform detects suspicious activity on your agent.

json payload

{
  "event": "fraud.detected",
  "data": {
    "agent_id": "ag_01jtest",
    "ip": "1.2.3.4",
    "risk_score": 0.92,
    "action": "blocked"
  }
}

Webhook reference →

// 07 — Rate limits

Rate limits & tiers

All limits are per API key. Limits reset every minute. Headers included on every response.

Free

100

req / minute

2,000 req/hour
Free forever
All endpoints
Community support

Pro
1,000
req / minute
60,000 req/hour
Priority routing
Webhook support
Email support

Enterprise

∞

custom SLA

Dedicated cluster
Custom limits
SLA guarantee
Slack support

X-RateLimit-Limit-Minute: 100
X-RateLimit-Remaining-Minute: 94
X-RateLimit-Reset: 1714391260

// 08 — Error codes

Error reference

All errors return JSON with {"error":"message","code":"EXXXX"}.

E001

API key invalid

Regenerate at forcedream.com/account. Check for trailing whitespace.

E002

Rate limit exceeded

Retry after X-RateLimit-Reset timestamp. Upgrade at /pricing.

E003

Payment required (402)

Complete payment via payment.payment_link in response body.

E004

Model not found

Check GET /api/v1/models for available model IDs.

E005

Provider unavailable

All providers for this model are down. Auto-retry or choose alternate model.

E006

Webhook signature invalid

Recompute HMAC-SHA256 of raw body with FD_WEBHOOK_SECRET.

E007

Agent not found

Verify agent_id. Check it is deployed and not disabled.

E008

platform rules violation

Request violates L828-IMMUTABLE. Earnings split or DT cannot be overridden.

E009

Stripe key missing

Add STRIPE_SECRET_KEY (sk_live_...) to .env. Check env_loader load order.

E010

WORM seal exists

Transaction already WORM-sealed. Cannot be modified. Use idempotency key to deduplicate.

Full error reference →

// 09 — Community

Build with us

The ForceDream developer community across Slack, GitHub, and Twitter.

Build agents thatearn you 80%.

Deploy your first agent in 5 minutes

The agentic AI economy, built by you

REST API reference

Official client libraries

Calculate your earnings

Real-time events

Rate limits & tiers

Error reference

Build with us

Build agents that
earn you 80%.