This guide explains how the credit system works and how to top up your wallet to start making API calls.
How credits work
Every API operation deducts a fixed number of credits from your wallet balance. Credits never expire — you can use them whenever you want, with no time pressure. Your balance is shared across all your API tokens.
How to top up
Call the topup endpoint with your chosen package slug. The response contains a checkout_url — open it in your browser to complete payment via Paddle. Credits are added automatically after payment confirmation.
POST /api/v1/wallet/topup curl -X POST https://alexambros.com/api/v1/wallet/topup \ -H "Authorization: Bearer sk_api_xxxx" \ -H "Content-Type: application/json" \ -d '{ "package_slug": "pack_1000" }'
{
"status": "success",
"data": {
"checkout_url": "https://alexambros.com/checkout-pay?_ptxn=txn_01...",
"package": "pack_1000",
"credits": 1000
}
}
After payment, verify your new balance by calling GET /api/v1/wallet.
Check your balance
At any time you can check your current balance and total credits purchased.
GET /api/v1/wallet curl https://alexambros.com/api/v1/wallet \ -H "Authorization: Bearer sk_api_xxxx"
{
"status": "success",
"data": {
"balance": 99845,
"total_purchased": 100000
}
}
Transaction history
Every credit deduction and top-up is recorded. Use the transactions endpoint to audit your usage — each entry shows the operation, amount, and balance after the transaction.
GET /api/v1/wallet/transactions curl "https://alexambros.com/api/v1/wallet/transactions?page=1" \ -H "Authorization: Bearer sk_api_xxxx"
{
"status": "success",
"data": [
{
"type": "withdrawal",
"amount": "20.00",
"balance_after": "99038.00",
"description": "Wywołanie API: api.v1.companies.search",
"created_at": "2026-03-21T11:47:08.000000Z"
},
{
"type": "deposit",
"amount": "100000.00",
"balance_after": "100000.00",
"description": "Wallet top-up: pack_1000",
"created_at": "2026-03-17T09:00:00.000000Z"
}
]
}
Tip
Browsing your watchlist (GET /companies/watched) is completely free — no credits are deducted. Use it to check your monitored companies without worrying about balance.