Dokumentacja API

Doładowania kryptowalutami

Aktualizacja: październik 2026

Doładuj saldo kryptowalutą: pobierz adres wpłaty i dokładną kwotę, wyślij dokładnie tę kwotę, zgłoś wysłanie płatności (identyfikator transakcji jest opcjonalny), a następnie śledź doładowanie do momentu zaksięgowania środków. Saldo służy do opłacania dowolnego z naszych planów.

7 min czytania

Punkty końcowe na tej stronie

GET /v1/catalog/coins: Akceptowane kryptowaluty i sieci (wraz z przypisanym adresem wpłaty)
POST /v1/topups: Rozpocznij doładowanie salda kryptowalutą (stały adres, dokładna kwota)
POST /v1/topups/{topUpId}/txid: Zgłoś wysłanie płatności (TXID opcjonalny)
GET /v1/topups/{topUpId}: Pobierz doładowanie (sprawdzaj na bieżąco jego status)
GET /v1/topups: Wyświetl listę doładowań kryptowalutami

Podstawowy URL https://localserpproxy.com/api/v1. Informacje o uwierzytelnianiu, błędach i limitach znajdziesz w omówieniu API.

Akceptowane kryptowaluty i sieci (ze stałym adresem wpłaty)

GET/v1/catalog/coins

Publiczne: klucz API nie jest wymagany.

Odpowiedź `200 OK`

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

Przykłady kodu

curl

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

Python

import os
import requests

API = "https://localserpproxy.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://localserpproxy.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());

Rozpocznij doładowanie salda kryptowalutą (stały adres, dokładna kwota)

POST/v1/topups

amountUsd ≥ 25.00 USD i ≤ limitu maksymalnego (domyślnie 10,000.00): 422 na amountUsd, w przeciwnym razie.
coin + network musi być jedną z wartości GET /v1/catalog/coins (w przeciwnym razie 409 coin_unavailable).
Zwraca stały address sieci oraz dokładną kwotę amountCrypto = amountUsd / rate, zaokrągloną w górę do precyzji danej kryptowaluty (BTC/LTC/ETH/SOL: 8 miejsc po przecinku, USDT/USDC: 6), a także niewielką, unikalną różnicę w ostatnich cyfrach, dzięki której żadne 2 otwarte doładowania w tej samej sieci nie wymagają wpłaty tej samej kwoty. rate jest zablokowany do expiresAt (30 minut); txidDeadline = expiresAt + 72 h.
Opcjonalne purchase (taka sama treść jak POST /v1/orders): weryfikowane i wyceniane od razu (422 z nazwami pól poprzedzonymi przez purchase., 409 plan_unavailable…). amountUsd musi pokryć łączną kwotę purchase − bieżące saldo (422 too_small na amountUsd). Po zaksięgowaniu doładowania zamówienie jest składane z salda w ramach tej samej transakcji; purchase.status zmienia się na completed (z orderId) lub failed (failureReason; środki pozostają na saldzie).

Uwierzytelnianie: klucz API w nagłówku Authorization: Bearer API_KEY.

Parametry

Nazwa	W	Typ	Wymagane	Opis
`Idempotency-Key`	header	string	Nie	Unikalny klucz (np. UUID) umożliwiający bezpieczne ponowienie żądania POST. Przechowywany przez 24 h. — maks. 128 znaków

Treść żądania

Pole	Typ	Wymagane	Opis
`amountUsd`	string (USD, 2 decimals)	Tak	Kwota do dodania w USD: ≥ 25.00, domyślnie ≤ 10,000.00.
`coin`	string	Tak	—
`network`	string	Tak	—
`purchase`	object	Nie	Plan zakupu z salda po zaksięgowaniu doładowania (taka sama treść jak `POST /v1/orders`).

Przykład: Saldo

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

Przykład: Finalizacja zamówienia

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

Odpowiedź `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": "Local team",
    "quantity": 1,
    "options": {},
    "promoCode": null,
    "total": "7.50",
    "status": "pending",
    "orderId": null,
    "failureReason": null
  },
  "createdAt": "2026-10-05T14:03:11Z"
}

Przykłady kodu

curl

curl -s -X POST "https://localserpproxy.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://localserpproxy.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://localserpproxy.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());

Zgłoś wysłanie płatności (TXID opcjonalny)

POST/v1/topups/{topUpId}/txid

Zgłoś wysłanie płatności, gdy środki opuszczą Twój portfel lub giełdę: to odpowiednik przycisku „Wysłałem płatność” w API. Identyfikator transakcji (TXID) jest opcjonalny: wyślij puste body ({}) albo dodaj txid, jeśli go masz. Płatność jest dopasowywana do tego doładowania na podstawie dokładnej kwoty (amountCrypto) w jego sieci i na jego adresie, dlatego wyślij dokładnie tę kwotę.

Zgłoszenie jest przyjmowane, gdy doładowanie ma status awaiting_payment, expired lub rejected, i przed txidDeadline (expiresAt + 72 h): późne zgłoszenie nigdy nie powoduje utraty płatności. Podany txid jest sprawdzany pod kątem formatu właściwego dla danej sieci (422 na txid) i nie może być przypisany do innego doładowania (409 txid_already_used). Zamknięte doładowanie zwraca 409 topup_closed. Następnie doładowanie ma status verifying na czas weryfikacji płatności w blockchainie i kończy się statusem credited po potwierdzeniu transakcji przez sieć albo rejected (z rejection).

Uwierzytelnianie: klucz API w nagłówku Authorization: Bearer API_KEY.

Parametry

Nazwa	W	Typ	Wymagane	Opis
`topUpId`	path	string	Tak	—

Treść żądania

Pole	Typ	Wymagane	Opis
`txid`	string	Nie	Opcjonalnie. Hash transakcji: 64 znaki szesnastkowe (bitcoin, litecoin, tron), 0x + 64 znaki szesnastkowe (ethereum), podpis base58 (solana). Puste lub pominięte: płatność jest dopasowywana na podstawie dokładnej kwoty. — maks. 128 znaków

Przykład: Płatność wysłana

{}

Przykład: Podaj TXID (opcjonalnie)

{
  "txid": "4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b"
}

Odpowiedź `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": "Local team",
    "quantity": 1,
    "options": {},
    "promoCode": null,
    "total": "7.50",
    "status": "pending",
    "orderId": null,
    "failureReason": null
  },
  "createdAt": "2026-10-05T14:03:11Z"
}

Przykłady kodu

curl

curl -s -X POST "https://localserpproxy.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://localserpproxy.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://localserpproxy.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());

Doładuj konto (sprawdzaj bieżący status)

GET/v1/topups/{topUpId}

Odpytuj tę trasę, aby śledzić doładowanie: co 10 s, gdy status = verifying, co 30 s podczas oczekiwania na płatność i zakończ, gdy final = true. Doładowanie otrzymuje status expired, jeśli przed expiresAt nie zgłoszono wysłania płatności; zgłoszenie nadal będzie możliwe do txidDeadline.

Uwierzytelnianie: klucz API w nagłówku Authorization: Bearer API_KEY.

Parametry

Nazwa	W	Typ	Wymagane	Opis
`topUpId`	path	string	Tak	—

Odpowiedź `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": "Local team",
    "quantity": 1,
    "options": {},
    "promoCode": null,
    "total": "7.50",
    "status": "pending",
    "orderId": null,
    "failureReason": null
  },
  "createdAt": "2026-10-05T14:03:11Z"
}

Przykłady kodu

curl

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

Python

import os
import requests

API = "https://localserpproxy.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://localserpproxy.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());

Lista doładowań kryptowalutami

GET/v1/topups

Uwierzytelnianie: klucz API w nagłówku Authorization: Bearer API_KEY.

Parametry

Nazwa	W	Typ	Wymagane	Opis
`page`	query	integer	Nie	≥ 1, domyślnie `1`
`perPage`	query	integer	Nie	1–100, domyślnie `20`
`status`	query	`awaiting_payment` · `verifying` · `credited` · `rejected` · `expired`	Nie	`final` = zaksięgowane lub wygasłe / odrzucone po `txidDeadline`.

Odpowiedź `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": "Local team",
        "quantity": 1,
        "options": {},
        "promoCode": null,
        "total": "7.50",
        "status": "pending",
        "orderId": null,
        "failureReason": null
      },
      "createdAt": "2026-10-05T14:03:11Z"
    }
  ],
  "pagination": {
    "page": 1,
    "perPage": 20,
    "total": 1,
    "totalPages": 1
  }
}

Przykłady kodu

curl

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

Python

import os
import requests

API = "https://localserpproxy.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

// Node.js 18+ (built-in fetch), ES module
const API = 'https://localserpproxy.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());

Akceptowane kryptowaluty i sieci (ze stałym adresem wpłaty)

Odpowiedź 200 OK

Przykłady kodu

Rozpocznij doładowanie salda kryptowalutą (stały adres, dokładna kwota)

Parametry

Treść żądania

Odpowiedź 201 Created

Przykłady kodu

Zgłoś wysłanie płatności (TXID opcjonalny)

Parametry

Treść żądania

Odpowiedź 200 OK

Przykłady kodu

Doładuj konto (sprawdzaj bieżący status)

Parametry

Odpowiedź 200 OK

Przykłady kodu

Lista doładowań kryptowalutami

Parametry

Odpowiedź 200 OK

Przykłady kodu

Powiązane strony

Odpowiedź `200 OK`

Odpowiedź `201 Created`

Odpowiedź `200 OK`

Odpowiedź `200 OK`

Odpowiedź `200 OK`