# GET /v1/balance

Lihat saldo

Saldo publisher saat ini: `available` adalah jumlah yang dapat diminta untuk pembayaran, `pending` adalah estimasi pendapatan (hari yang belum difinalisasi AGIMone; belum dapat dibayarkan sebelum final), `requested` adalah jumlah dalam permintaan pembayaran yang masih terbuka, `paid_total` adalah total yang sudah dibayarkan, dan `min_payout` adalah jumlah pembayaran minimum. Semua jumlah berupa string uang. Angkanya sama dengan kolom `balance` pada GET /v1/earnings. Memerlukan scope `publisher:read` (kunci API atau sesi web). Tingkat batas laju: `read`.

- Scope wajib: `publisher:read`
- Batas laju: `read` — 120 permintaan per jendela 60 detik per kunci API atau sesi web

## Parameter

Tanpa parameter.

## Respons

```
{ available: string; held: string; min_payout: string; paid_total: string; pending: string; requested: string }
```

## Error

Rute yang dibatasi lajunya mengembalikan `RateLimit-Limit`, `RateLimit-Remaining`, dan `RateLimit-Reset` (detik hingga jendela berakhir); respons 429 juga menyertakan `Retry-After`. Header ini bisa tidak ada saat pembatas laju sementara tidak tersedia (permintaan lalu diteruskan).

| Status | Arti |
|---|---|
| 401 | Kunci API tidak ada, tidak valid, atau sudah dicabut. |
| 403 | Kunci tidak memiliki scope yang diperlukan, atau operasi tidak diizinkan untuk aktor ini. |
| 429 | Batas laju terlampaui; tunggu `Retry-After` detik. |

## Contoh

### cURL

```bash
#!/usr/bin/env bash
# GET /v1/balance: current balance (pending, available, requested, paid_total, min_payout).
# Needs: AGIMONE_API_KEY (create one at https://app.agimone.com/app/account/api-keys). Optional: AGIMONE_API_BASE.
set -euo pipefail
BASE="${AGIMONE_API_BASE:-https://app.agimone.com}"
curl -fsS -H "Authorization: Bearer $AGIMONE_API_KEY" "$BASE/v1/balance"
echo
```

### Node.js

```js
// GET /v1/balance: current balance (pending, available, requested, paid_total, min_payout). Node 18+, no dependencies.
// Needs: AGIMONE_API_KEY (create one at https://app.agimone.com/app/account/api-keys). Optional: AGIMONE_API_BASE.
const base = process.env.AGIMONE_API_BASE ?? 'https://app.agimone.com';

const res = await fetch(`${base}/v1/balance`, {
  headers: { Authorization: `Bearer ${process.env.AGIMONE_API_KEY}` },
});
if (!res.ok) {
  console.error(`HTTP ${res.status}: ${await res.text()}`);
  process.exit(1);
}
console.log(JSON.stringify(await res.json()));
```

### PHP

```php
<?php
// GET /v1/balance: current balance (pending, available, requested, paid_total, min_payout). PHP 8 with the curl extension, no other dependencies.
// Needs: AGIMONE_API_KEY (create one at https://app.agimone.com/app/account/api-keys). Optional: AGIMONE_API_BASE.
$base = getenv('AGIMONE_API_BASE') ?: 'https://app.agimone.com';

$ch = curl_init("$base/v1/balance");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('AGIMONE_API_KEY')],
    CURLOPT_TIMEOUT => 15,
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
if ($body === false || $status >= 400) {
    fwrite(STDERR, "HTTP $status: " . ($body === false ? curl_error($ch) : $body) . "\n");
    exit(1);
}
curl_close($ch);
echo trim($body), "\n";
```

### Python

```python
# GET /v1/balance: current balance (pending, available, requested, paid_total, min_payout). Python 3.8+, standard library only.
# Needs: AGIMONE_API_KEY (create one at https://app.agimone.com/app/account/api-keys). Optional: AGIMONE_API_BASE.
import json
import os
import sys
import urllib.error
import urllib.request

base = os.environ.get("AGIMONE_API_BASE", "https://app.agimone.com")
req = urllib.request.Request(
    f"{base}/v1/balance",
    headers={"Authorization": f"Bearer {os.environ['AGIMONE_API_KEY']}"},
)
try:
    with urllib.request.urlopen(req, timeout=15) as res:
        print(json.dumps(json.load(res)))
except urllib.error.HTTPError as e:
    print(f"HTTP {e.code}: {e.read().decode()}", file=sys.stderr)
    sys.exit(1)
```

Dokumentasi HTML: https://agimone.com/id/developers/api/#get-balance
API 2026-10
