Wuraren kira a wannan shafin
GET /v1/catalog/coins: Crypto da hanyoyin sadarwar da ake karɓa (da tabbataccen adireshin ajiyarsu)POST /v1/topups: Fara cika saura da crypto (adireshi tabbatacce, adadi daidai)POST /v1/topups/{topUpId}/txid: Sanar da cewa an aika kuɗi (TXID na zaɓi)GET /v1/topups/{topUpId}: Duba cika asusu (maimaita kira don matsayinsa na yanzu)GET /v1/topups: Jera cika asusu da crypto
URL na asali https://africaproxies.com/api/v1. Tabbatar da shiga, kurakurai da iyaka: duba bayanin API.
Crypto da hanyoyin sadarwar da ake karɓa (da tabbataccen adireshin ajiyarsu)
GET/v1/catalog/coins
Baiwa: ba a buƙatar mabuɗin API.
Amsa 200 OK
{
"data": [
{
"code": "BTC",
"name": "Bitcoin",
"networks": [
{
"id": "bitcoin",
"name": "Bitcoin",
"confirmationsRequired": 2,
"estimatedMinutes": null,
"memoRequired": false,
"address": "DEPOSIT_ADDRESS"
}
]
}
]
}Misalan lambobin kwamfuta
curl -s "https://africaproxies.com/api/v1/catalog/coins"import os
import requests
API = "https://africaproxies.com/api/v1"
r = requests.get(f"{API}/catalog/coins", timeout=30)
r.raise_for_status()
print(r.json())// Node.js 18+ (built-in fetch), ES module
const API = 'https://africaproxies.com/api/v1';
const res = await fetch(`${API}/catalog/coins`);
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());Fara cika saura da crypto (adireshi tabbatacce, adadi daidai)
POST/v1/topups
amountUsd≥ 25.00 USD kuma ≤ iyaka (10,000.00 a tsohon saiti): in ba haka ba422a kanamountUsd.coin+networkdole su kasance cikinGET /v1/catalog/coins(in ba haka ba409 coin_unavailable).- Yana mayar da tabbataccen
addressna hanyar sadarwa da ainihinamountCrypto=amountUsd/rate, an zagaye shi sama zuwa daidaiton tsabar (BTC/LTC/ETH/SOL wuraren goma 8, USDT/USDC 6), tare da ɗan ƙarin adadi na musamman a lambobin ƙarshe domin cika asusu biyu da suke buɗe a hanyar ɗaya kada su nemi adadi ɗaya. Ana kulleratehar zuwaexpiresAt(mintuna 30);txidDeadline=expiresAt+ 72 h. purchasena zaɓi (jiki ɗaya daPOST /v1/orders): ana tabbatarwa da ƙayyade farashi yanzu (422da sunayen filaye masu farkonpurchase.,409 plan_unavailable…). DoleamountUsdya rufe jimillarpurchase− saura na yanzu (422 too_smalla kanamountUsd). Da zarar an ƙara kuɗin cika asusu, ana yin odar daga saura cikin ciniki ɗaya;purchase.statusyana zamacompleted(daorderId) kofailed(failureReason; kuɗin suna nan cikin saura).
Authentication: API madaidaiciya a cikin Authorization: Bearer API_KEY taken.
Ma'aunin aiki
| Suna | A cikin | Nau'i | Abin bukata | Bayani |
|---|---|---|---|---|
Idempotency-Key | header | string | A'a | Maɓalli na musamman (misali UUID) don sake gwada POST cikin aminci. Ana riƙe shi 24 h. — iyakar haruffa 128 |
Sashin buƙata
| Fasali | Nau'i | Abin bukata | Bayani |
|---|---|---|---|
amountUsd | string (USD, 2 decimals) | I | USD da za a ƙara: ≥ 25.00, ≤ 10,000.00 a tsohon saiti. |
coin | string | I | — |
network | string | I | — |
purchase | object | A'a | Tsarin da za a saya daga saura idan an ƙara kuɗin cika asusu (jiki ɗaya da POST /v1/orders). |
{
"amountUsd": "50.00",
"coin": "USDT",
"network": "tron"
}{
"amountUsd": "25.00",
"coin": "BTC",
"network": "bitcoin",
"purchase": {
"planId": "res-10",
"quantity": 1
}
}Amsa 201 Created
{
"id": "top_7d2kq9x1",
"status": "verifying",
"final": false,
"amountUsd": "25.00",
"coin": "USDT",
"network": "tron",
"address": "DEPOSIT_ADDRESS",
"amountCrypto": "25.000137",
"rate": "1.00",
"paymentUri": "PAYMENT_URI",
"expiresAt": "2026-10-05T14:33:11Z",
"txidDeadline": "2026-10-08T14:33:11Z",
"confirmationsRequired": 20,
"confirmations": 7,
"txid": "9d2e5c0b1f7a4e3d8c6b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f41c7",
"txidSubmittedAt": "2026-10-05T14:09:42Z",
"amountReceivedCrypto": "25.000137",
"explorerUrl": "https://tronscan.org/#/transaction/9d2e5c0b1f7a4e3d8c6b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f41c7",
"creditedUsd": null,
"creditedAt": null,
"rejection": null,
"purchase": {
"planId": "res-10",
"planName": "Team",
"quantity": 1,
"options": {},
"promoCode": null,
"total": "5.94",
"status": "pending",
"orderId": null,
"failureReason": null
},
"createdAt": "2026-10-05T14:03:11Z"
}Misalan lambobin kwamfuta
curl -s -X POST "https://africaproxies.com/api/v1/topups" \
-H "Authorization: Bearer $API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"amountUsd":"50.00","coin":"USDT","network":"tron"}'import os, uuid
import requests
API = "https://africaproxies.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}", "Idempotency-Key": str(uuid.uuid4())}
r = requests.post(f"{API}/topups", headers=HEADERS, json={"amountUsd": "50.00", "coin": "USDT", "network": "tron"}, timeout=30)
r.raise_for_status()
print(r.json())// Node.js 18+ (built-in fetch), ES module
import { randomUUID } from 'node:crypto';
const API = 'https://africaproxies.com/api/v1';
const res = await fetch(`${API}/topups`, {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.API_KEY}`, 'Idempotency-Key': randomUUID(), 'Content-Type': 'application/json' },
body: JSON.stringify({ amountUsd: '50.00', coin: 'USDT', network: 'tron' }),
});
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());Sanar da cewa an aika kuɗi (TXID na zaɓi)
POST/v1/topups/{topUpId}/txid
Ka sanar cewa an aika kuɗi da zarar sun fita daga wallet ko dandalin musayarka: wannan shi ne nau'in API na maɓallin “Na aika kuɗin”. ID na ciniki (TXID) zaɓi ne: aika jiki marar komai ({}), ko ƙara txid idan kana da shi. Ana danganta kuɗinka da wannan cika asusu ta ainihin adadinsa (amountCrypto) a hanyar sadarwa da adireshin cika asusun, don haka aika wannan adadin daidai.
Ana karɓa yayin da cika asusu yake awaiting_payment, expired ko rejected, kuma kafin txidDeadline (expiresAt + 72 h): sanarwa da ta makara ba ta sa kuɗi su ɓacewa. Idan an bayar da txid, ana bincika tsarin hanyar sadarwarsa (422 a kan txid), kuma wani cika asusu bai kamata ya riga ya yi amfani da shi ba (409 txid_already_used). Cika asusu da aka rufe yana mayar da 409 topup_closed. Daga nan cika asusun yana zama verifying yayin binciken blockchain, sannan ya ƙare da credited idan hanyar sadarwa ta tabbatar da cinikin, ko rejected (tare da rejection).
Authentication: API madaidaiciya a cikin Authorization: Bearer API_KEY taken.
Ma'aunin aiki
| Suna | A cikin | Nau'i | Abin bukata | Bayani |
|---|---|---|---|---|
topUpId | path | string | I | — |
Sashin buƙata
| Fasali | Nau'i | Abin bukata | Bayani |
|---|---|---|---|
txid | string | A'a | Na zaɓi. Hash na ciniki: 64 hex (bitcoin, litecoin, tron), 0x + 64 hex (ethereum), sa hannun base58 (solana). Idan babu ko yana fanko: ana daidaita kuɗi ta ainihin adadinsu. — iyakar haruffa 128 |
{}{
"txid": "4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b"
}Amsa 200 OK
{
"id": "top_7d2kq9x1",
"status": "verifying",
"final": false,
"amountUsd": "25.00",
"coin": "USDT",
"network": "tron",
"address": "DEPOSIT_ADDRESS",
"amountCrypto": "25.000137",
"rate": "1.00",
"paymentUri": "PAYMENT_URI",
"expiresAt": "2026-10-05T14:33:11Z",
"txidDeadline": "2026-10-08T14:33:11Z",
"confirmationsRequired": 20,
"confirmations": 7,
"txid": "9d2e5c0b1f7a4e3d8c6b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f41c7",
"txidSubmittedAt": "2026-10-05T14:09:42Z",
"amountReceivedCrypto": "25.000137",
"explorerUrl": "https://tronscan.org/#/transaction/9d2e5c0b1f7a4e3d8c6b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f41c7",
"creditedUsd": null,
"creditedAt": null,
"rejection": null,
"purchase": {
"planId": "res-10",
"planName": "Team",
"quantity": 1,
"options": {},
"promoCode": null,
"total": "5.94",
"status": "pending",
"orderId": null,
"failureReason": null
},
"createdAt": "2026-10-05T14:03:11Z"
}Misalan lambobin kwamfuta
curl -s -X POST "https://africaproxies.com/api/v1/topups/top_7d2kq9x1/txid" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{}'import os
import requests
API = "https://africaproxies.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}
r = requests.post(f"{API}/topups/top_7d2kq9x1/txid", headers=HEADERS, json={}, timeout=30)
r.raise_for_status()
print(r.json())// Node.js 18+ (built-in fetch), ES module
const API = 'https://africaproxies.com/api/v1';
const res = await fetch(`${API}/topups/top_7d2kq9x1/txid`, {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.API_KEY}`, 'Content-Type': 'application/json' },
body: JSON.stringify({}),
});
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());Duba cika asusu (maimaita kira don matsayinsa na yanzu)
GET/v1/topups/{topUpId}
Maimaita kiran wannan hanya don bin cika asusu: kowane 10 s yayin status = verifying, kowane 30 s yayin jiran kuɗi, ka tsaya idan final = true. Cika asusu yana zama expired idan ba a sanar da aika kuɗin ba kafin expiresAt; ana iya sanarwa har zuwa txidDeadline.
Authentication: API madaidaiciya a cikin Authorization: Bearer API_KEY taken.
Ma'aunin aiki
| Suna | A cikin | Nau'i | Abin bukata | Bayani |
|---|---|---|---|---|
topUpId | path | string | I | — |
Amsa 200 OK
{
"id": "top_7d2kq9x1",
"status": "verifying",
"final": false,
"amountUsd": "25.00",
"coin": "USDT",
"network": "tron",
"address": "DEPOSIT_ADDRESS",
"amountCrypto": "25.000137",
"rate": "1.00",
"paymentUri": "PAYMENT_URI",
"expiresAt": "2026-10-05T14:33:11Z",
"txidDeadline": "2026-10-08T14:33:11Z",
"confirmationsRequired": 20,
"confirmations": 7,
"txid": "9d2e5c0b1f7a4e3d8c6b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f41c7",
"txidSubmittedAt": "2026-10-05T14:09:42Z",
"amountReceivedCrypto": "25.000137",
"explorerUrl": "https://tronscan.org/#/transaction/9d2e5c0b1f7a4e3d8c6b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f41c7",
"creditedUsd": null,
"creditedAt": null,
"rejection": null,
"purchase": {
"planId": "res-10",
"planName": "Team",
"quantity": 1,
"options": {},
"promoCode": null,
"total": "5.94",
"status": "pending",
"orderId": null,
"failureReason": null
},
"createdAt": "2026-10-05T14:03:11Z"
}Misalan lambobin kwamfuta
curl -s "https://africaproxies.com/api/v1/topups/top_7d2kq9x1" \
-H "Authorization: Bearer $API_KEY"import os
import requests
API = "https://africaproxies.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}
r = requests.get(f"{API}/topups/top_7d2kq9x1", headers=HEADERS, timeout=30)
r.raise_for_status()
print(r.json())// Node.js 18+ (built-in fetch), ES module
const API = 'https://africaproxies.com/api/v1';
const res = await fetch(`${API}/topups/top_7d2kq9x1`, {
headers: { Authorization: `Bearer ${process.env.API_KEY}` },
});
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());Jera cika asusu da crypto
GET/v1/topups
Authentication: API madaidaiciya a cikin Authorization: Bearer API_KEY taken.
Ma'aunin aiki
| Suna | A cikin | Nau'i | Abin bukata | Bayani |
|---|---|---|---|---|
page | query | integer | A'a | ≥ 1, tsohon saiti 1 |
perPage | query | integer | A'a | 1–100, tsohon saiti 20 |
status | query | awaiting_payment · verifying · credited · rejected · expired | A'a | final = an ƙara kuɗi, ko ya ƙare / an ƙi shi bayan txidDeadline. |
Amsa 200 OK
{
"data": [
{
"id": "top_7d2kq9x1",
"status": "verifying",
"final": false,
"amountUsd": "25.00",
"coin": "USDT",
"network": "tron",
"address": "DEPOSIT_ADDRESS",
"amountCrypto": "25.000137",
"rate": "1.00",
"paymentUri": "PAYMENT_URI",
"expiresAt": "2026-10-05T14:33:11Z",
"txidDeadline": "2026-10-08T14:33:11Z",
"confirmationsRequired": 20,
"confirmations": 7,
"txid": "9d2e5c0b1f7a4e3d8c6b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f41c7",
"txidSubmittedAt": "2026-10-05T14:09:42Z",
"amountReceivedCrypto": "25.000137",
"explorerUrl": "https://tronscan.org/#/transaction/9d2e5c0b1f7a4e3d8c6b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e7d6c5b4a3f41c7",
"creditedUsd": null,
"creditedAt": null,
"rejection": null,
"purchase": {
"planId": "res-10",
"planName": "Team",
"quantity": 1,
"options": {},
"promoCode": null,
"total": "5.94",
"status": "pending",
"orderId": null,
"failureReason": null
},
"createdAt": "2026-10-05T14:03:11Z"
}
],
"pagination": {
"page": 1,
"perPage": 20,
"total": 1,
"totalPages": 1
}
}Misalan lambobin kwamfuta
curl -s "https://africaproxies.com/api/v1/topups" \
-H "Authorization: Bearer $API_KEY"import os
import requests
API = "https://africaproxies.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}
r = requests.get(f"{API}/topups", headers=HEADERS, timeout=30)
r.raise_for_status()
print(r.json())// Node.js 18+ (built-in fetch), ES module
const API = 'https://africaproxies.com/api/v1';
const res = await fetch(`${API}/topups`, {
headers: { Authorization: `Bearer ${process.env.API_KEY}` },
});
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());