Files
openrouter-python-sdk-retry…/docs/sdks/credits
2025-11-13 14:21:27 -05:00
..
2025-11-13 14:21:27 -05:00

Credits

(credits)

Overview

Credit management endpoints

Available Operations

get_credits

Get total credits purchased and used for the authenticated user

Example Usage

from openrouter import OpenRouter
import os


with OpenRouter(
    api_key=os.getenv("OPENROUTER_API_KEY", ""),
) as open_router:

    res = open_router.credits.get_credits()

    # Handle response
    print(res)

Parameters

Parameter Type Required Description
retries Optional[utils.RetryConfig] Configuration to override the default retry behavior of the client.

Response

operations.GetCreditsResponse

Errors

Error Type Status Code Content Type
errors.UnauthorizedResponseError 401 application/json
errors.ForbiddenResponseError 403 application/json
errors.InternalServerResponseError 500 application/json
errors.OpenRouterDefaultError 4XX, 5XX */*

create_coinbase_charge

Create a Coinbase charge for crypto payment

Example Usage

from openrouter import OpenRouter, operations
import os


with OpenRouter() as open_router:

    res = open_router.credits.create_coinbase_charge(security=operations.CreateCoinbaseChargeSecurity(
        bearer=os.getenv("OPENROUTER_BEARER", ""),
    ), amount=100, sender="0x1234567890123456789012345678901234567890", chain_id=1)

    # Handle response
    print(res)

Parameters

Parameter Type Required Description
security operations.CreateCoinbaseChargeSecurity ✔️ N/A
amount float ✔️ N/A
sender str ✔️ N/A
chain_id components.ChainID ✔️ N/A
retries Optional[utils.RetryConfig] Configuration to override the default retry behavior of the client.

Response

operations.CreateCoinbaseChargeResponse

Errors

Error Type Status Code Content Type
errors.BadRequestResponseError 400 application/json
errors.UnauthorizedResponseError 401 application/json
errors.TooManyRequestsResponseError 429 application/json
errors.InternalServerResponseError 500 application/json
errors.OpenRouterDefaultError 4XX, 5XX */*