Get top-up link

POST

https://api.spicyapi.com/api/v1/tools/get_topup_link

Checkout URL to add funds by card (hosted checkout) or crypto for a preset amount (100, 500, 50). The USER opens it and pays in the browser; never enter payment details yourself. The balance is credited by the payment webhook; call get_account afterwards. Works with a 0 balance.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Examples

Responses

🟢200

The tool's JSON result (same payload the MCP tool returns).

This response does not have a body.

🟠400

🟠401

🟠402

🟠403

🟠429

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.spicyapi.com/api/v1/tools/get_topup_link' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "amount_usd": -9007199254740991,
    "method": "card"
}'

Modified at 2026-09-21 21:07:45

Revoke API key

Set spend limit