Documentation

Overview

API Deals provides access to Anthropic's Claude models through a fully compatible REST API at 20% below official pricing. Your existing code that targets the Anthropic Messages API works with API Deals out of the box — just swap the base URL and API key.

Base URL:  https://api.apideals.org
Endpoint:  POST /v1/messages

Every request is routed through AWS Bedrock, giving you the same model quality and latency guarantees as the official API while we handle billing, usage tracking, and cost optimization on your behalf.

Authentication

All API calls are authenticated with a bearer token. You can find and rotate your API key from the Dashboard → API Key page.

curl https://api.apideals.org/v1/messages \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{ "model": "claude-sonnet-4-5-20250514", "max_tokens": 1024, "messages": [...] }'

Sending Messages

The request and response format is identical to the Anthropic Messages API. Here is a minimal example:

POST /v1/messages
Content-Type: application/json
Authorization: Bearer sk-your-api-key
anthropic-version: 2023-06-01

{
  "model": "claude-sonnet-4-5-20250514",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "What is the capital of France?"
    }
  ]
}

Response

{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "content": [
    { "type": "text", "text": "The capital of France is Paris." }
  ],
  "model": "claude-sonnet-4-5-20250514",
  "usage": {
    "input_tokens": 14,
    "output_tokens": 10
  }
}

Both streaming (stream: true) and non-streaming responses are supported. When streaming, the API returns server-sent events (SSE) in the same format as the official Anthropic API.

Multimodal Input: Text, Images & PDFs

Claude models are multimodal. You can send text, images, and PDF documentsin a single request. Each message's content field accepts an array of content blocks:

Text

{ "type": "text", "text": "Describe this image." }

Images

Send images as base64-encoded data. Supported formats: image/jpeg, image/png, image/gif, and image/webp.

{
  "type": "image",
  "source": {
    "type": "base64",
    "media_type": "image/jpeg",
    "data": "<base64-encoded-image>"
  }
}

PDF Documents

Upload PDFs as base64 content blocks. Claude will extract and reason over the document's text and visual content.

{
  "type": "document",
  "source": {
    "type": "base64",
    "media_type": "application/pdf",
    "data": "<base64-encoded-pdf>"
  }
}

Combined Example

{
  "model": "claude-sonnet-4-5-20250514",
  "max_tokens": 2048,
  "messages": [
    {
      "role": "user",
      "content": [
        { "type": "text", "text": "Compare the chart in this image with the data in the PDF." },
        {
          "type": "image",
          "source": {
            "type": "base64",
            "media_type": "image/png",
            "data": "<base64-chart>"
          }
        },
        {
          "type": "document",
          "source": {
            "type": "base64",
            "media_type": "application/pdf",
            "data": "<base64-report>"
          }
        }
      ]
    }
  ]
}

Pricing & Cost Calculation

Costs are calculated per request based on the number of tokens consumed. Each response includes a usage object with exact token counts.

How Costs Are Calculated

input_cost  = (input_tokens  / 1,000,000) × input_price_per_1M
output_cost = (output_tokens / 1,000,000) × output_price_per_1M
total_cost  = input_cost + output_cost

Claude Sonnet 4.5 Pricing

You can monitor your spending in real time from Dashboard → Usage. Each request is logged with its token count, cost, latency, and status.

Supported Models

The following Claude models are available through API Deals. Pass the model ID in the model field of your request.

Use GET /v1/models to retrieve the up-to-date list of available models and their current pricing tiers.

Wallet & Billing

API Deals uses a prepaid wallet system. You deposit funds into your wallet, and each API request automatically deducts the computed cost from your balance.

Wallet Balance

Your wallet has three components:

• Available Balance— funds available for API usage
• Locked Balance— funds reserved for pending transactions
• Bonus Credit— promotional or sign-up credits

Deposits

Fund your wallet via cryptocurrency deposits (BTC, ETH, USDT, and more). Deposits are confirmed on-chain and credited to your wallet automatically.

Billing Periods

Usage is aggregated into monthly billing periods. You can view per-period breakdowns including total requests, tokens consumed, and costs from the Dashboard → Usage page.

Rate Limits

Rate limits are applied per API key to ensure fair usage across all customers. When you exceed the limit, the API returns a 429 status code with a RATE_LIMITED error.

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Too many requests. Please retry after a short delay.",
    "status": 429
  }
}

Best practice: implement exponential backoff with jitter in your client. Most official Anthropic SDKs handle this automatically.

Error Handling

All errors follow a consistent envelope format:

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable description.",
    "status": 400
  }
}