Skip to main content
Retrieve unified pricing information for all Swarms API usage dimensions from the /v1/usage/costs endpoint. This includes token costs, agent costs, search/scrape operations, image pricing, MCP calls, and night-time discount multipliers.
The pricing endpoint is read-only and safe to call in automation. Always treat returned values as dynamic and avoid hard-coding pricing in production systems.

Quick Start

import os
import json
import requests
from dotenv import load_dotenv

load_dotenv()

API_KEY = os.getenv("SWARMS_API_KEY")
BASE_URL = "https://api.swarms.world"

headers = {
    "x-api-key": API_KEY,
    "Content-Type": "application/json",
}

def get_pricing_details() -> dict | None:
    """Fetch comprehensive pricing details."""
    resp = requests.get(f"{BASE_URL}/v1/usage/costs", headers=headers)

    if resp.status_code == 200:
        return resp.json()

    print(f"Error: {resp.status_code} - {resp.text}")
    return None

if __name__ == "__main__":
    data = get_pricing_details()
    if data:
        print("✅ Pricing details retrieved successfully!")
        print(json.dumps(data, indent=2))

        usage = data.get("usage_pricing", {})
        print("\n--- Key fields ---")
        print("Swarm input /1M:", usage.get("swarm_completions_input_cost_per_1m"))
        print("Swarm output /1M:", usage.get("swarm_completions_output_cost_per_1m"))
        print("Agent image cost:", usage.get("agent_completions_img_cost"))
        print("Night-time discount:", usage.get("night_time_discount"))

Response Shape

The endpoint returns a usage_pricing object plus a timestamp:
{
  "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": "2024-01-01T12:00:00Z"
}