Setup Guide

PennyPrompt is an OpenAI-compatible API. Point any client at it by changing the base URL and API key.

Prerequisites

1. Get an API key — Connect your wallet on the Dashboard to get your pp_live_ key.

2. Fund your account — Deposit USDC on Base to your deposit address. Balance updates within 2 minutes.

3. Use it — Pick your client below and follow the guide.

OpenCode Integration

Full agentic coding with PennyPrompt auto-routing.

1. Add the provider

Add to ~/.config/opencode/opencode.json (global) or opencode.json in your project root:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "pennyprompt": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "PennyPrompt",
      "options": {
        "baseURL": "https://pennyprompt.xyz/v1"
      },
      "models": {
        "auto": {
          "name": "PennyPrompt Auto-Route",
          "limit": {
            "context": 128000,
            "output": 16384
          }
        }
      }
    }
  }
}

2. Add the credential

Run /connect in the OpenCode TUI, scroll to Other, enter pennyprompt as the provider ID, and paste your pp_live_ key.

// ~/.local/share/opencode/auth.json
{
  "pennyprompt": {
    "type": "api",
    "key": "pp_live_aBcDeFgHiJkLmNoPqRsTuVwXyZ012345"
  }
}

3. Select the model

Run /models in OpenCode and pick PennyPrompt Auto-Route.

FAQ

What model does PennyPrompt use?

PennyPrompt auto-selects the cheapest model that meets quality requirements. The "model" field in requests is accepted for compatibility but ignored. The actual model used is returned in the response.

Does streaming work?

Yes. Add "stream": true to the request body. PennyPrompt returns Server-Sent Events in the standard OpenAI format.

Does tool calling work?

Yes. The full OpenAI tool-calling interface (tools, tool_choice, tool_calls, tool_call_id) is passed through transparently. Agentic clients like OpenCode work out of the box.

What happens if my balance runs out?

PennyPrompt returns HTTP 402 with your deposit addresses. Top up and continue — no data is lost.

What USDC networks are supported?

Base (EVM). Deposit USDC on Base to the deposit address shown on your Dashboard.