یک واریز یا فهرست واریزها

GET/v1/deposits

با id یک واریز را می‌دهد. بی id یک صفحه می‌دهد، تازه‌ترین اول. total فقط در صفحه‌ی اول عدد است. همه‌ی فیلترها اختیاری‌اند، فقط مقدار دقیق را می‌سنجند و با هم ترکیب می‌شوند.

دسترسی لازم

read

سقف نرخ در دقیقه

120 برای هر کلید

درخواست

curl

curl 'https://api.romu.ir/v1/deposits?network=TRON&status=confirmed&limit=50' \
  -H "X-Custody-Key-Id: $KEY_ID" \
  -H "X-Custody-Timestamp: $TIMESTAMP" \
  -H "X-Custody-Nonce: $NONCE" \
  -H "X-Custody-Signature: $SIGNATURE"

TypeScript

import { romu } from "./romu.ts";

const res = await romu.get("/v1/deposits", {
  query: "network=TRON&status=confirmed&limit=50",
});
console.log(res.status, res.body);

Go

status, body, err := client.Get("/v1/deposits", "network=TRON&status=confirmed&limit=50")

Python

import romu

status, body = romu.get(
    "/v1/deposits",
    query="network=TRON&status=confirmed&limit=50",
)
print(status, body)

امضای درخواست را کتابخانه انجام می‌دهد؛ جزئیات: صفحه‌ی امضا

پارامترهای query

idUUID

شناسه‌ی واریز.

wallet_idUUID

شناسه‌ی کیف پول، مثل 0192f19f-1d2c-7f3b-8a4e-6b7c8d9e0f12⁠.

address_idUUID

شناسه‌ی آدرس، مثل 0192f1b2-3333-7f3b-8a4e-6b7c8d9e0f01⁠.

assetstring

کد دارایی، مثل TRON_USDT⁠.

networkstring

شبکه، مثل TRON⁠.TRONBSC

statusstring

وضعیت، مثل confirmed⁠. تکرارپذیر است.detectedconfirmedreorged

to_addressstring

آدرس واریز، مثل TE48BLyVNUSHicSrpwaoRh4SQqXSkoG5S5⁠.

tx_hashstring

هش زنجیره، مثل afac59572365099a560875a7ace8c9dbbecd562d3750b9702c59f6ef935d7c7c⁠. حروف بزرگ و کوچک هش hex فرقی ندارند.

fromRFC 3339

شروع بازه روی detected_at⁠، خود این لحظه هم حساب است. RFC 3339، مثل 2026-10-01T00:00:00Z⁠.

toRFC 3339

پایان بازه روی detected_at⁠، تا پیش از این لحظه. RFC 3339، مثل 2026-11-01T00:00:00Z⁠.

cursorstring

مقدار next_cursor پاسخ قبلی.

limitinteger

1 تا 200.

پاسخ

200یک واریز (با id⁠) یا یک صفحه.

نمونه

{
  "deposits": [
    {
      "id": "0192f1b1-2222-7a10-b2c3-d4e5f6a7b801",
      "wallet_id": "0192f19f-1d2c-7f3b-8a4e-6b7c8d9e0f12",
      "address_id": "0192f1b2-3333-7f3b-8a4e-6b7c8d9e0f01",
      "network": "TRON",
      "asset": "TRON_TRX",
      "amount": "25",
      "amount_raw": "25000000",
      "tx_hash": "afac59572365099a560875a7ace8c9dbbecd562d3750b9702c59f6ef935d7c7c",
      "confirmations": 19,
      "status": "confirmed",
      "to_address": "TE48BLyVNUSHicSrpwaoRh4SQqXSkoG5S5",
      "from_address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
      "detected_at": "2026-10-09T08:15:30Z",
      "confirmed_at": "2026-10-09T08:16:30Z"
    }
  ],
  "next_cursor": "",
  "total": 1
}

فیلدها با id

depositobjectلازم

deposit.idUUID

deposit.wallet_idUUID

deposit.address_idUUID

deposit.networkstring

TRONBSC

deposit.assetstring

کد دارایی، مثل TRON_TRX⁠.

deposit.amountstring

مبلغی که اعتبار می‌شود، رشته‌ی اعشاری در واحد خود دارایی، مثل 100.5⁠. واریزی که چند انتقال کوچک را جمع کرده کل جمع را نشان می‌دهد.

deposit.amount_rawstring

همان مبلغ در کوچک‌ترین واحد، برای تطبیق دقیق.

deposit.tx_hashstring

هش انتقال. در واریز جمع‌شده هش آخرین انتقال است.

deposit.tx_hashesstring[]

فقط در واریز جمع‌شده می‌آید: همه‌ی تراکنش‌هایی که این واریز پوشش می‌دهد، قدیمی‌ترین اول و tx_hash آخر.

deposit.confirmationsinteger

deposit.statusstring

detectedconfirmedreorged

deposit.to_addressstring

deposit.from_addressstring

deposit.detected_atRFC 3339

deposit.confirmed_atRFC 3339 | null

فیلدها بی id

depositsobject[]لازم

deposits[].idUUID

deposits[].wallet_idUUID

deposits[].address_idUUID

deposits[].networkstring

TRONBSC

deposits[].assetstring

کد دارایی، مثل TRON_TRX⁠.

deposits[].amountstring

مبلغی که اعتبار می‌شود، رشته‌ی اعشاری در واحد خود دارایی، مثل 100.5⁠. واریزی که چند انتقال کوچک را جمع کرده کل جمع را نشان می‌دهد.

deposits[].amount_rawstring

همان مبلغ در کوچک‌ترین واحد، برای تطبیق دقیق.

deposits[].tx_hashstring

هش انتقال. در واریز جمع‌شده هش آخرین انتقال است.

deposits[].tx_hashesstring[]

فقط در واریز جمع‌شده می‌آید: همه‌ی تراکنش‌هایی که این واریز پوشش می‌دهد، قدیمی‌ترین اول و tx_hash آخر.

deposits[].confirmationsinteger

deposits[].statusstring

detectedconfirmedreorged

deposits[].to_addressstring

deposits[].from_addressstring

deposits[].detected_atRFC 3339

deposits[].confirmed_atRFC 3339 | null

next_cursorstringلازم

totalinteger | nullلازم

خطاها

400invalid request یا malformed request body⁠: بدنه، پارامتر یا فیلد نادرست است، یا فیلد ناشناخته دارد.

401unauthenticated⁠: هر شکست احراز هویت همین پاسخ را دارد.

403permission denied⁠: کلید دسترسی این مسیر را ندارد.

404not found⁠: مسیر یا شیء پیدا نشد. خواندن کیف پولی بیرون از فهرست کلید هم همین است.

429too many requests⁠: بیش از سقف نرخ. پس از Retry-After ثانیه دوباره بفرستید.

503try again later⁠: سرویس موقتاً در دسترس نیست.

بدنه‌ی خطا همیشه {"error":"..."} است. راهنمای خطاها می‌گوید برای هر کد چه باید کرد.