Swarms API Documentation - Build AI Agents & Multi-Agent Systems

This page details the pricing structure and how credits are deducted for various API operations.

To upgrade your plan, visit the Account Dashboard, open the Billing tab, and select your tier.

API Subscriptions

Flexible subscription plans that scale with your needs. Choose a plan for higher limits and features; usage is billed per operation.

Plans at a glance

Plan	Monthly price	Discount %	Annual price	Premium Endpoints	Rate limits	Support	Best for	Key features
Free	$0	N/A	$0/year	No	100/min, 350/hr, 1,200/day	Community	Getting started	Basic API, pay‑per‑use, community support, Marketplace access
Pro	$19.99	15%	$203.90/year	Yes	2,000/min, 10,000/hr, 100,000/day	Priority	Professionals	Premium models, Premium Endpoints access
Ultra	$100	15%	$1,020/year	Yes	2,000/min, 10,000/hr, 100,000/day	Priority	Teams & production	Everything in Pro, higher token-per-agent limit, full Premium Endpoints

Prices shown are subscription fees; API usage is billed per operation (see Usage-based pricing below). Rate limits shown are those returned by GET /v1/rate/limits for any account with an active premium subscription (pro, ultra, or premium tier) — see Rate Limits for how free vs. premium tiers are resolved.

Some plan-comparison items you may see elsewhere (e.g. SOC 2 certification, dedicated infrastructure, or request-priority routing) are account/infrastructure-level facts that could not be verified against the Swarms API application source and are intentionally omitted from this table. See Security and Priority Processing for what is verifiable.

Update your plan in 3 steps

Go to the Account Dashboard.
Open the Billing tab and scroll down to the Plans section.
Select your desired plan. You’ll be redirected to Stripe to complete payment.

Free

Get started with AI. No monthly fees — pay only for usage.

Sign-up bonus credits
Basic API access
Pay-per-use pricing
Community support
Standard processing speed
Access to the Marketplace
Note: Premium endpoints (batch processing, reasoning agents, advanced workflows) are not available on the free tier

Pro

Most popular. Perfect for professionals who need more power and features.

$19.99/month (save 15% with annual billing)
Higher rate limits: 2,000 req/min, 10,000 req/hour, 100,000 req/day, 2M tokens per agent (vs. free tier’s 100/350/1,200 and 200K — see Rate Limits)
Access to premium-only models (see below)
Access to Premium Endpoints: Unlock batch processing, reasoning agents, and advanced workflows
- /v1/agent/batch/completions - High-throughput batch agent processing
- /v1/swarm/batch/completions - Batch swarm completions
- /v1/reasoning-agent/completions - Advanced reasoning capabilities
- /v1/batched-grid-workflow/completions - Grid workflow execution
- Plus graph workflows
- See full list: Premium Endpoints

Ultra

Best for growing teams and production workloads that need higher limits and security.

$100/month (save 15% with annual billing)
Everything in Pro. Note: per api/schemas.py (RateLimitsPremiumTier), Pro and Ultra currently resolve to the same numeric rate limits and per-agent token limit — any account with an active subscription (pro, ultra, or premium tier) gets the same premium allowances.
Full access to Premium Endpoints
For compliance certifications and enhanced-security specifics, see Security

Premium-Only Models

Free tier accounts are blocked from requesting the following models on any endpoint (including /v1/agent/completions and /v1/swarm/completions), regardless of available credits. Any active Pro or Ultra subscription unlocks all of them — there is no separate model tier between Pro and Ultra:

gpt-5.6-sol
gpt-5.6-terra
gpt-5.6-luna
gpt-5.6
claude-fable-5
claude-opus-5
claude-opus-4-8
gemini-3.1-pro
gemini-3.1-deep-think
xai/grok-4.5
xai/grok-4.5-latest
Any groq/* model

Requesting one of these models on the free tier returns a 403 error with suggested free-tier alternatives.

Enterprise

Critical support, compliance, and control for large-scale enterprises.

Contact sales for custom pricing
Dedicated 24/7 support
Custom solutions engineering
Onsite training and onboarding
Custom agent development
No rate limits
Access to experimental features

Usage-based pricing

Pay only for what you use with transparent, per-operation pricing. All API endpoints use a unified pricing structure for token costs.

Pricing Table

Item	Price	Unit	Notes
Input Tokens	$6.50	per 1M tokens	Unified pricing across all endpoints
Output Tokens	$18.50	per 1M tokens	Unified pricing across all endpoints
Agent Cost	$0.01	per agent	For swarms and workflows
Image Processing	$0.25	per image	Charged when image provided
MCP Call	$0.10	per call	Charged when MCP URL provided
Exa Search Tool	$0.04	per search	Charged per search execution
Web Scraper Tool	$0.15	per scrape	Charged per scrape execution
Night-time Discount	50% off tokens	8 PM - 6 AM PT	Swarm Completions only

Unified Pricing

All API endpoints use the same token pricing:

Input Tokens: $6.50 per 1 million tokens
Output Tokens: $18.50 per 1 million tokens

This applies to:

Endpoint	Notes
Swarm Completions	Agent cost applies ($0.01/agent); night-time discount applies to tokens
Agent Completions	No per-agent fee
Graph Workflow	Agent cost applies ($0.01/agent), billed at agent-completion token rates; no night-time discount
Batched Grid Workflow	Agent cost applies ($0.01/agent), billed at agent-completion token rates; no night-time discount
Auto Agent Builder	Agent cost applies ($0.01/agent), billed at agent-completion token rates; no night-time discount

Discounts

Night Time Discount: Swarm completions receive a 50% discount on token costs during 8 PM - 6 AM Pacific Time. Agent costs remain the same.

Retrieving Current Costs

You can retrieve the current pricing using the /v1/usage/costs endpoint:

GET /v1/usage/costs

Example Response:

{
  "usage_pricing": {
    "swarm_completions_agent_cost": 0.01,
    "swarm_completions_input_cost_per_1m": 6.5,
    "swarm_completions_output_cost_per_1m": 18.5,
    "agent_completions_input_cost_per_1m": 6.5,
    "agent_completions_output_cost_per_1m": 18.5,
    "agent_completions_img_cost": 0.25,
    "agent_completions_mcp_cost": 0.1,
    "search_cost": 0.04,
    "scrape_cost": 0.15,
    "night_time_discount": 0.5
  },
  "timestamp": "2026-03-29T18:30:00+00:00"
}

Checking Your Credit Balance

Use GET /v1/account/credits to check your current balance before making billable requests:

curl -H "x-api-key: $SWARMS_API_KEY" \
     https://api.swarms.world/v1/account/credits

{
  "credit": 12.50,
  "free_credit": 3.00,
  "referral_credits": 20.00,
  "total_credits": 35.50
}

total_credits is the sum of credit, free_credit, and referral_credits — this is the number checked against the $1.00 minimum for billable routes.

Important Notes

Important Note	Description
Minimum Balance	Billable completion endpoints require a total credit balance above $1.00, checked before the request runs. Requests below this are rejected with a 402 Payment Required error before any work is done.
Credits Deduction	Credits are deducted automatically after each request completes.
Credits Usage Order	Deducted in this order: `free_credit` first, then `referral_credits`, then regular `credit`.
Token Counting	Token counts are calculated using model-specific tokenizers.
Pricing Updates	Pricing may be updated periodically. Check `/v1/usage/costs` for current pricing.

Getting Started

Clients

Agent Completions

Multi-Agent

Batch

Capabilities

Resources

Swarms Cloud

Pricing

API Subscriptions

Plans at a glance

Update your plan in 3 steps

Free

Pro

Ultra

Premium-Only Models

Enterprise

Usage-based pricing

Pricing Table

Unified Pricing

Discounts

Retrieving Current Costs

Checking Your Credit Balance

Important Notes

​API Subscriptions

​Plans at a glance

​Update your plan in 3 steps

​Free

​Pro

​Ultra

​Premium-Only Models

​Enterprise

​Usage-based pricing

​Pricing Table

​Unified Pricing

​Discounts

​Retrieving Current Costs

​Checking Your Credit Balance

​Important Notes

API Subscriptions

Plans at a glance

Update your plan in 3 steps

Free

Pro

Ultra

Premium-Only Models

Enterprise

Usage-based pricing

Pricing Table

Unified Pricing

Discounts

Retrieving Current Costs

Checking Your Credit Balance

Important Notes