Softbot Credit Packs

{
  "protocolVersion": "0.3.0",
  "name": "Softbot Credit Packs",
  "description": "Prepaid USDC credit for every paid Softbot tool. Buy a pack with x402, then send the secret key as X-Credit-Key. This is a plain HTTPS JSON API paid with x402, not an A2A JSON-RPC server. GET /v1/packs and GET /v1/credits do not settle or debit.",
  "url": "https://softbot-credits-mainnet.softbot.workers.dev",
  "preferredTransport": "HTTP+JSON",
  "version": "1.0.0",
  "provider": {
    "organization": "Softbot Studio",
    "url": "https://softbot-studio.pages.dev"
  },
  "documentationUrl": "https://softbot-credits-mainnet.softbot.workers.dev/llms.txt",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false,
    "extensions": [
      {
        "uri": "https://x402.org",
        "description": "Pack purchase via x402 v2",
        "required": false,
        "params": {
          "protocol": "x402",
          "version": 2,
          "scheme": "exact",
          "currency": "USDC",
          "decimals": 6,
          "networks": [
            {
              "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
              "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
              "facilitator": "https://facilitator.payai.network",
              "pay_to": "9csHbkGGeQqNxvtZw8hPnC34NCcmZoZXVTEGC1MiDNRE"
            },
            {
              "network": "eip155:8453",
              "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "facilitator": "https://api.cdp.coinbase.com/platform/v2/x402",
              "pay_to": "0xC68F3cCa31D50208ab4C933a38288938e0B21E63"
            },
            {
              "network": "eip155:137",
              "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
              "facilitator": "https://api.cdp.coinbase.com/platform/v2/x402",
              "pay_to": "0xC68F3cCa31D50208ab4C933a38288938e0B21E63"
            },
            {
              "network": "eip155:42161",
              "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
              "facilitator": "https://api.cdp.coinbase.com/platform/v2/x402",
              "pay_to": "0xC68F3cCa31D50208ab4C933a38288938e0B21E63"
            }
          ],
          "credit_packs": {
            "url": "https://softbot-credits-mainnet.softbot.workers.dev/v1/packs",
            "balance_url": "https://softbot-credits-mainnet.softbot.workers.dev/v1/credits",
            "method": "POST /v1/packs/{starter|regular|larger} paid with x402; GET /v1/packs and GET /v1/credits are free",
            "header": "X-Credit-Key",
            "idempotency_header": "Idempotency-Key",
            "secrecy": "The credit key is a bearer secret shown in the purchase response. It is stored only as a hash. Replay the same settled payment to recover it. Do not log it or put it in a URL.",
            "packs": [
              {
                "id": "starter",
                "pay_usdc": "0.25",
                "credit_usdc": "0.25"
              },
              {
                "id": "regular",
                "pay_usdc": "1",
                "credit_usdc": "1.05"
              },
              {
                "id": "larger",
                "pay_usdc": "5",
                "credit_usdc": "5.50"
              }
            ],
            "networks": [
              "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
              "eip155:8453",
              "eip155:137",
              "eip155:42161"
            ],
            "asset": "USDC",
            "usable_on": "Every paid Softbot tool, at that tool's existing per-call price. The key does not change those prices.",
            "not_accepted_for": "Buying more credits. Pack purchase is x402 only; credit keys and free trials are refused.",
            "no_withdrawal": true,
            "no_renewal": true,
            "balance_example": {
              "request": "GET /v1/credits with header X-Credit-Key",
              "response": {
                "balance_micros": 247000,
                "balance_usdc": "0.247"
              },
              "after": "A Starter pack ($0.25) minus one Reader call ($0.003)."
            },
            "failure": {
              "invalid_key": "401 invalid_credit_key. Does not settle x402 and does not use a free trial.",
              "insufficient": "402 insufficient_credit with no PAYMENT-REQUIRED header. Balance unchanged. Not an x402 challenge.",
              "ambiguous": "400 ambiguous_credentials if X-Credit-Key is combined with PAYMENT-SIGNATURE, X-PAYMENT, or SIGN-IN-WITH-X. Nothing is charged.",
              "tool_failure": "Tool status >= 400 refunds the reserved credit. Repeating the refund does not credit twice.",
              "success_retry": "A completed Idempotency-Key returns 409 credit_already_charged and is not charged again. The tool result is not stored.",
              "in_progress": "409 credit_charge_in_progress while the same Idempotency-Key is running. No second debit.",
              "get_head": "GET and HEAD never settle, mint, or debit."
            }
          },
          "unpaid_response": "HTTP 402 with PAYMENT-REQUIRED header on POST /v1/packs/:packId only",
          "get_head_settles": false,
          "trials_accepted": false,
          "credit_keys_accepted_as_payment": false
        }
      }
    ]
  },
  "securitySchemes": {
    "x402": {
      "type": "apiKey",
      "in": "header",
      "name": "PAYMENT-SIGNATURE",
      "description": "x402 v2 payment for POST /v1/packs/:packId."
    },
    "creditKey": {
      "type": "apiKey",
      "in": "header",
      "name": "X-Credit-Key",
      "description": "Bearer credit key for GET /v1/credits. Not accepted as payment for a pack."
    }
  },
  "security": [
    {
      "x402": []
    }
  ],
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "skills": [
    {
      "id": "pack-starter",
      "name": "starter pack (pay 0.25 USDC, receive 0.25 credit)",
      "description": "POST https://softbot-credits-mainnet.softbot.workers.dev/v1/packs/starter. Pay 0.25 USDC via x402, receive 0.25 credit. The credit_key is a bearer secret.",
      "tags": [
        "x402",
        "credit-pack",
        "usdc",
        "starter"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "pack-regular",
      "name": "regular pack (pay 1.00 USDC, receive 1.05 credit)",
      "description": "POST https://softbot-credits-mainnet.softbot.workers.dev/v1/packs/regular. Pay 1.00 USDC via x402, receive 1.05 credit. The credit_key is a bearer secret.",
      "tags": [
        "x402",
        "credit-pack",
        "usdc",
        "regular"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "pack-larger",
      "name": "larger pack (pay 5.00 USDC, receive 5.50 credit)",
      "description": "POST https://softbot-credits-mainnet.softbot.workers.dev/v1/packs/larger. Pay 5.00 USDC via x402, receive 5.50 credit. The credit_key is a bearer secret.",
      "tags": [
        "x402",
        "credit-pack",
        "usdc",
        "larger"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    }
  ],
  "supportsAuthenticatedExtendedCard": false,
  "links": {
    "openapi": "https://softbot-credits-mainnet.softbot.workers.dev/openapi.json",
    "llms_txt": "https://softbot-credits-mainnet.softbot.workers.dev/llms.txt",
    "x402": "https://softbot-credits-mainnet.softbot.workers.dev/.well-known/x402",
    "github": "https://github.com/softbot-studio/softbot-agents",
    "store": "https://softbot-studio.pages.dev/llms.txt"
  }
}