تاریخچه‌ی sweep

GET/v1/sweeps

یک صفحه از sweep ها، تازه‌ترین اول.

دسترسی لازم

read

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

120 برای هر کلید

درخواست

curl

curl 'https://api.romu.ir/v1/sweeps?status=completed&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/sweeps", {
  query: "status=completed&limit=50",
});
console.log(res.status, res.body);

Go

status, body, err := client.Get("/v1/sweeps", "status=completed&limit=50")

Python

import romu

status, body = romu.get(
    "/v1/sweeps",
    query="status=completed&limit=50",
)
print(status, body)

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

پارامترهای query

wallet_idUUID

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

group_idUUID

address_idUUID

assetstring

کد دارایی.

statusstring

تکرارپذیر است.pendingcompletedfailed

fromRFC 3339

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

toRFC 3339

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

cursorstring

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

limitinteger

1 تا 200.

پاسخ

200یک صفحه از sweep ها.

فیلدها

sweepsobject[]لازم

sweeps[].idstring

sweeps[].wallet_idstring

sweeps[].group_idstring

sweeps[].groupstring

sweeps[].address_idstring

sweeps[].labelstring

sweeps[].from_addressstring

sweeps[].to_addressstring

sweeps[].networkstring

TRONBSC

sweeps[].assetstring

sweeps[].amountstring

رشته‌ی اعشاری در واحد خود دارایی، مثل 100.5⁠.

sweeps[].amount_rawstring

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

sweeps[].tx_idstring

تراکنش را با GET /v1/transactions?id= بخوانید.

sweeps[].statusstring

pendingcompletedfailed

sweeps[].failurestring | null

sweeps[].sweep_request_idstring | null

شناسه‌ی درخواست POST /v1/sweeps⁠. برای sweep زمان‌بندی‌شده null است.

sweeps[].tx_hashstring | null

sweeps[].fee_actualstring | null

sweeps[].created_atRFC 3339

sweeps[].completed_atRFC 3339 | null

next_cursorstringلازم

خطاها

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

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

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

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

500internal error⁠: آدرس نشان داده نشد. به رومو خبر دهید.

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

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