دارایی‌های یک کیف پول

GET/v1/wallets/assets

یک صفحه از دارایی‌های کیف پول، بزرگ‌ترین ارزش اول، با مبلغ، ارزش دلاری، نرخ و زمان خواندن.

دسترسی لازم

readیاwithdraw

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

120 برای هر کلید

درخواست

curl

curl 'https://api.romu.ir/v1/wallets/assets?wallet_id=0192f19f-1d2c-7f3b-8a4e-6b7c8d9e0f12' \
  -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/wallets/assets", {
  query: "wallet_id=0192f19f-1d2c-7f3b-8a4e-6b7c8d9e0f12",
});
console.log(res.status, res.body);

Go

status, body, err := client.Get("/v1/wallets/assets", "wallet_id=0192f19f-1d2c-7f3b-8a4e-6b7c8d9e0f12")

Python

import romu

status, body = romu.get(
    "/v1/wallets/assets",
    query="wallet_id=0192f19f-1d2c-7f3b-8a4e-6b7c8d9e0f12",
)
print(status, body)

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

پارامترهای query

wallet_idUUIDلازم

شناسه‌ی کیف پول.

cursorstring

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

limitinteger

1 تا 200.

پاسخ

200یک صفحه از دارایی‌ها.

نمونه

{
  "assets": [
    {
      "asset": "TRON_USDT",
      "network": "TRON",
      "amount": "25",
      "usd_value": "25",
      "rate_usd": "1",
      "read_at": "2026-10-14T07:10:00Z"
    }
  ],
  "next_cursor": ""
}

فیلدها

assetsobject[]لازم

assets[].assetstringلازم

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

assets[].networkstringلازم

TRONBSC

assets[].amountstringلازم

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

assets[].usd_valuestring | null

ارزش دلاری، هرگز صفر به جای «بی نرخ».

assets[].rate_usdstring | null

assets[].read_atRFC 3339 | null

next_cursorstringلازم

خطاها

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

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

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

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

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

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

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