የAPI ማጣቀሻ

የክሪፕቶ ሂሳብ መሙያዎች

ቀሪ ሂሳቡን በክሪፕቶ ይሙሉ፦ የመሙያ አድራሻውንና ትክክለኛውን መጠን ያግኙ፣ ያንኑ መጠን ይላኩ፣ ክፍያ መላኩን ያሳውቁ (የግብይት ID አማራጭ ነው)፣ ከዚያ ቀሪ ሂሳቡ እስኪጨመር ድረስ መሙያውን ይከታተሉ። ቀሪ ሂሳቡ ከእቅዶቻችን ለማንኛውም ይከፍላል።

የመጨረሻው መዘመን: 15 ኦክቶበር 2026 · 7 ደቂቃ ንባብ

በዚህ ገጽ ያሉ መዳረሻዎች

GET /v1/catalog/coins: የሚቀበሉ ክሪፕቶ ሳንቲሞችና ኔትወርኮች (ከቋሚ የመሙያ አድራሻቸው ጋር)
POST /v1/topups: የክሪፕቶ ሂሳብ መሙያ ይጀምሩ (ቋሚ አድራሻ፣ ትክክለኛ መጠን)
POST /v1/topups/{topUpId}/txid: ክፍያ መላኩን ያሳውቁ (TXID አማራጭ)
GET /v1/topups/{topUpId}: የሂሳብ መሙያ ያግኙ (ወቅታዊ ሁኔታውን በድጋሚ ጥሪ ይከታተሉ)
GET /v1/topups: የክሪፕቶ ሂሳብ መሙያዎችን ይዘርዝሩ

መሠረታዊ URL https://africaproxies.com/api/v1። የመለያ ማረጋገጫ፣ ስህተቶችና ገደቦች፦ የAPI አጠቃላይ መግለጫ ይመልከቱ።

የሚቀበሉ ክሪፕቶ ሳንቲሞችና ኔትወርኮች (ከቋሚ የመሙያ አድራሻቸው ጋር)

GET/v1/catalog/coins

የሕዝብ፡ ምንም API ቁልፍ አያስፈልግም።

ምላሽ `200 OK`

{
  "data": [
    {
      "code": "BTC",
      "name": "Bitcoin",
      "networks": [
        {
          "id": "bitcoin",
          "name": "Bitcoin",
          "confirmationsRequired": 2,
          "estimatedMinutes": null,
          "memoRequired": false,
          "address": "DEPOSIT_ADDRESS"
        }
      ]
    }
  ]
}

የኮድ ምሳሌዎች

curl

curl -s "https://africaproxies.com/api/v1/catalog/coins"

Python

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

// 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());

የክሪፕቶ ሂሳብ መሙያ ይጀምሩ (ቋሚ አድራሻ፣ ትክክለኛ መጠን)

POST/v1/topups

amountUsd ≥ 25.00 USD እና ≤ ከፍተኛው ገደብ (ነባሪ 10,000.00)፤ ካልሆነ በ amountUsd ላይ 422።
coin + network በ GET /v1/catalog/coins ከተዘረዘሩት አንዱ መሆን አለበት (ካልሆነ 409 coin_unavailable)።
የኔትወርኩን ቋሚ address እና ትክክለኛ amountCrypto = amountUsd / rate ይመልሳል፣ ይህም እንደ ሳንቲሙ ትክክለኛነት ወደ ላይ ይጠጋጋል (BTC/LTC/ETH/SOL 8 የአስርዮሽ ቦታዎች፣ USDT/USDC 6)። በተጨማሪም በመጨረሻዎቹ አሃዞች ትንሽ ልዩ ጭማሪ ይኖራል፣ በተመሳሳይ ኔትወርክ ያሉ ሁለት ክፍት መሙያዎች አንድ ዓይነት መጠን እንዳይጠይቁ። rate እስከ expiresAt (30 ደቂቃ) ይቆለፋል፤ txidDeadline = expiresAt + 72 ሰዓት።
አማራጭ purchase (ከ POST /v1/orders ጋር ተመሳሳይ አካል)፦ አሁን ይረጋገጣል፣ ዋጋውም ይወሰናል (በ purchase. የሚጀምሩ የመስክ ስሞች ያላቸው 422፣ 409 plan_unavailable…)። amountUsd የ purchase ጠቅላላ − የአሁኑን ቀሪ ሂሳብ መሸፈን አለበት (በ amountUsd ላይ 422 too_small)። መሙያው ሲጨመር፣ ትዕዛዙ ከቀሪ ሂሳብ በተመሳሳይ ግብይት ይፈጸማል፤ purchase.status፣ completed (ከ orderId ጋር) ወይም failed (failureReason፤ ገንዘቡ በቀሪ ሂሳብ ይቆያል) ይሆናል።

ማረጋገጫ፦ የAPI ቁልፍ በAuthorization: Bearer API_KEY ራስጌ ውስጥ።

ፓራሜትሮች

ስም	በ	ዓይነት	አስፈላጊ	መግለጫ
`Idempotency-Key`	header	string	አይደለም	POST በደህንነት እንደገና ለመሞከር ልዩ ቁልፍ (ለምሳሌ UUID)። ለ24 ሰዓት ይቆያል። — እስከ 128 ቁምፊዎች

የጥያቄ አካል

መስክ	ዓይነት	አስፈላጊ	መግለጫ
`amountUsd`	string (USD, 2 decimals)	አዎ	የሚጨመር USD፦ በነባሪ ≥ 25.00፣ ≤ 10,000.00።
`coin`	string	አዎ	—
`network`	string	አዎ	—
`purchase`	object	አይደለም	መሙያው ወደ ሂሳብ ሲጨመር ከቀሪ ሂሳብ የሚገዛ እቅድ (ከ `POST /v1/orders` ጋር ተመሳሳይ አካል)።

ምሳሌ: ቀሪ ሂሳብ

{
  "amountUsd": "50.00",
  "coin": "USDT",
  "network": "tron"
}

ምሳሌ: የግዢ ክፍያ

{
  "amountUsd": "25.00",
  "coin": "BTC",
  "network": "bitcoin",
  "purchase": {
    "planId": "res-10",
    "quantity": 1
  }
}

ምላሽ `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"
}

የኮድ ምሳሌዎች

curl

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"}'

Python

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

// 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());

ክፍያ መላኩን ያሳውቁ (TXID አማራጭ)

POST/v1/topups/{topUpId}/txid

ገንዘቡ ከቦርሳዎ ወይም ከግብይት መድረኩ እንደወጣ ክፍያው መላኩን ያሳውቁ፤ ይህ የ«ክፍያውን ልኬያለሁ» ቁልፍ የAPI ተመሳሳይ ነው። የግብይት ID (TXID) አማራጭ ነው፤ ባዶ አካል ({}) ይላኩ፣ ወይም ካለዎት txid ይጨምሩ። ክፍያዎ ከዚህ የሂሳብ መሙያ ጋር የሚዛመደው በመሙያው ኔትወርክና አድራሻ ላይ ባለው ትክክለኛ መጠን (amountCrypto) ነው፤ ስለዚህ ያንኑ መጠን በትክክል ይላኩ።

መሙያው awaiting_payment፣ expired ወይም rejected ሳለ፣ እና ከ txidDeadline (expiresAt + 72 ሰዓት) በፊት ይቀበላል፤ ዘግይቶ ማሳወቅ ክፍያን አያሳጣም። txid ከተሰጠ፣ ከኔትወርኩ ቅርጽ ጋር ይፈተሻል (በ txid ላይ 422)፣ ሌላ መሙያም ከዚህ በፊት ጥቅም ላይ አውሎት መሆን የለበትም (409 txid_already_used)። የተዘጋ መሙያ 409 topup_closed ይመልሳል። ከዚያ በብሎክቼይን ክፍያው ሲፈተሽ መሙያው verifying ይሆናል፣ ኔትወርኩ ግብይቱን ሲያረጋግጥም credited ወይም rejected (ከ rejection ጋር) ሆኖ ያበቃል።

ማረጋገጫ፦ የAPI ቁልፍ በAuthorization: Bearer API_KEY ራስጌ ውስጥ።

ፓራሜትሮች

ስም	በ	ዓይነት	አስፈላጊ	መግለጫ
`topUpId`	path	string	አዎ	—

የጥያቄ አካል

መስክ	ዓይነት	አስፈላጊ	መግለጫ
`txid`	string	አይደለም	አማራጭ። የግብይት ሃሽ፦ 64 hex (bitcoin፣ litecoin፣ tron)፣ 0x + 64 hex (ethereum)፣ base58 ፊርማ (solana)። ባዶ ወይም ከሌለ፦ ክፍያው በትክክለኛው መጠን ይዛመዳል። — እስከ 128 ቁምፊዎች

ምሳሌ: ክፍያ ተልኳል

{}

ምሳሌ: ከ TXID ጋር (አማራጭ)

{
  "txid": "4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b"
}

ምላሽ `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"
}

የኮድ ምሳሌዎች

curl

curl -s -X POST "https://africaproxies.com/api/v1/topups/top_7d2kq9x1/txid" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Python

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

// 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());

የሂሳብ መሙያ ያግኙ (ወቅታዊ ሁኔታውን በድጋሚ ጥሪ ይከታተሉ)

GET/v1/topups/{topUpId}

መሙያን ለመከታተል ይህን መስመር በድጋሚ ይጥሩ፤ status = verifying ሳለ በእያንዳንዱ 10 ሰከንድ፣ ክፍያ ሲጠብቅ በእያንዳንዱ 30 ሰከንድ፣ final = true ሲሆንም ያቁሙ። ክፍያ ከ expiresAt በፊት መላኩ ካልተገለጸ፣ መሙያው expired ይሆናል፤ እስከ txidDeadline ድረስ ግን መላኩን ማሳወቅ ይቻላል።

ማረጋገጫ፦ የAPI ቁልፍ በAuthorization: Bearer API_KEY ራስጌ ውስጥ።

ፓራሜትሮች

ስም	በ	ዓይነት	አስፈላጊ	መግለጫ
`topUpId`	path	string	አዎ	—

ምላሽ `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"
}

የኮድ ምሳሌዎች

curl

curl -s "https://africaproxies.com/api/v1/topups/top_7d2kq9x1" \
  -H "Authorization: Bearer $API_KEY"

Python

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

// 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());