API Documentation

OpenAI-compatible API. Change your base URL, keep your code, fund the planet.

Quick Start

EcoRouter is a drop-in replacement for the OpenAI API. If your code works with OpenAI, it works with EcoRouter.

Python (OpenAI SDK)

from openai import OpenAI

client = OpenAI(
    base_url="https://api.ecorouter.org/v1",
    api_key="eco_sk_..."  # your EcoRouter API key
)

response = client.chat.completions.create(
    model="openai/gpt-4o-mini",
    messages=[{"role": "user", "content": "Hello!"}]
)
print(response.choices[0].message.content)

JavaScript (fetch)

const resp = await fetch("https://api.ecorouter.org/v1/chat/completions", {
    method: "POST",
    headers: {
        "Content-Type": "application/json",
        "Authorization": "Bearer eco_sk_..."
    },
    body: JSON.stringify({
        model: "openai/gpt-4o-mini",
        messages: [{"role": "user", "content": "Hello!"}]
    })
});

cURL

curl https://api.ecorouter.org/v1/chat/completions \
  -H "Authorization: Bearer eco_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o-mini",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Base URL & Authentication

All requests require an API key passed in the Authorization header. Get your key by signing up via the web UI or the /v1/auth/register endpoint.

Auth Endpoints

Parameter	Type		Description
email	string	required	Your email address
password	string	required	At least 6 characters

# Request
curl -X POST https://api.ecorouter.org/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "password": "secret123"}'

# Response
{
  "api_key": "eco_sk_a1b2c3...",
  "deposit_address": "TLqcLi5nz...",
  "deposit_hint": "Send any whole dollar amount + $0.042 cents (e.g. $10.042, $25.042)",
  "balance_usdt": 0
}

Parameter	Type		Description
email	string	required	Your email address
password	string	required	Your password

Chat Completions

This endpoint proxies directly to OpenRouter with your allocated credit. It supports all standard OpenAI parameters:

Parameter	Type		Description
model	string	required	Model ID, e.g. openai/gpt-4o, anthropic/claude-sonnet-4
messages	array	required	Array of message objects with role and content
stream	boolean		Stream response as SSE chunks
temperature	number		Sampling temperature (0-2)
max_tokens	integer		Maximum tokens to generate
tools	array		Function calling / tool use definitions

Models

EcoRouter routes through OpenRouter, giving you access to 200+ models. Use the full model ID with the provider prefix:

Model	ID
GPT-4o	openai/gpt-4o
GPT-4o Mini	openai/gpt-4o-mini
GPT-5	openai/gpt-5
Claude Sonnet 4	anthropic/claude-sonnet-4
Claude Opus 4	anthropic/claude-opus-4
Gemini 2.5 Flash	google/gemini-2.5-flash
Gemini 2.5 Pro	google/gemini-2.5-pro
DeepSeek V3	deepseek/deepseek-chat
DeepSeek R1	deepseek/deepseek-r1
Llama 4 Maverick	meta-llama/llama-4-maverick

For the full list, call GET /v1/models or browse openrouter.ai/models.

Balance & Deposits

# Response
{
  "api_credit_total_usdt": 8.90,
  "api_credit_used_usdt": 1.23,
  "api_credit_remaining_usdt": 7.67,
  "deposit_address": "TLqcLi5nz...",
  "deposit_cents_suffix": 42,
  "deposit_hint": "Send $X.042 to the deposit address"
}

Adding credits

Send USDT (TRC-20) to the deposit address shown in your balance response. Include your unique cents suffix so we can match the deposit to your account.

For example, if your suffix is 042, send $10.042, $25.042, etc. The deposit is credited automatically within ~60 seconds.

Pricing & Fee Split

EcoRouter charges the same per-token prices as the underlying providers (via OpenRouter). On top, there's an 11% fee split:

• 89% — your API credit (used for model inference)
• 10% — eco fund (donated monthly to environmental organizations)
• 1% — operations (servers, infrastructure)

All eco fund transactions are public on the Tron blockchain. See the transparency page for details.