خروجی CSV آدرس‌ها

GET/v1/addresses/export

همه‌ی آدرس‌های کیف پول را به صورت CSV می‌دهد، با UTF-8 و BOM، هر آدرس و شبکه یک ردیف. ستون‌ها: group⁠، label⁠، kind⁠، status⁠، network⁠، address⁠، created_at⁠، archived_at⁠، usd_value⁠، balances⁠. status یکی از active⁠، archived یا pending است. وقتی pending است، ستون address خالی است. به آن آدرس چیزی نفرستید. usd_value جمع ارزش دلاری آدرس روی همان شبکه است، طبق آخرین خواندن. اگر هنوز خوانده نشده یا قیمتی ندارد، خالی است. balances موجودی هر دارایی فعال آن شبکه است، به شکل «مقدار کد دارایی» و با | جدا شده، مثل 9.199 TRON_TRX|0 TRON_USDT⁠. مقدار به واحد خود دارایی است. اگر دانلود ناقص ماند، فایل را به کار نبرید.

دسترسی لازم

read

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

5 برای هر کلید

درخواست

curl

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

Go

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

Python

import romu

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

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

پارامترهای query

wallet_idUUIDلازم

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

groupstring

نام گروه.

labelstring

پیشوند برچسب.

statusstring

activearchived

kindstring

maindepositsweepfee

پاسخ

200فایل CSV.

خطاها

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

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

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

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

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

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

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