دارایی‌های پشتیبانی‌شده

GET/v1/assets

فهرست دارایی‌های رومو، برای همه‌ی سازمان‌ها یکسان، به ترتیب کد. واریز تازه‌ی دارایی disabled ثبت نمی‌شود، ولی موجودی‌اش هنوز برداشت و sweep می‌شود.

دسترسی لازم

read

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

120 برای هر کلید

درخواست

curl

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

Go

status, body, err := client.Get("/v1/assets", "network=TRON&limit=100")

Python

import romu

status, body = romu.get(
    "/v1/assets",
    query="network=TRON&limit=100",
)
print(status, body)

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

پارامترهای query

networkstring

نبودنش یعنی همه‌ی شبکه‌ها.TRONBSC

after_codestring

آخرین code صفحه‌ی قبل.

limitinteger

1 تا 500. پیش‌فرض 100.

پاسخ

200یک صفحه از فهرست.

نمونه

{
  "assets": [
    {
      "code": "TRON_TRX",
      "network": "TRON",
      "type": "native",
      "contract": "",
      "decimals": 6,
      "min_deposit": "1",
      "name": "TRON",
      "status": "active"
    },
    {
      "code": "TRON_USDT",
      "network": "TRON",
      "type": "trc20",
      "contract": "TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf",
      "decimals": 6,
      "min_deposit": "0.1",
      "name": "Tether USD",
      "status": "active"
    }
  ],
  "next_after_code": ""
}

فیلدها

assetsobject[]لازم

assets[].codestring

assets[].networkstring

TRONBSC

assets[].typestring

nativetrc20bep20

assets[].contractstring

برای سکه‌ی بومی خالی است.

assets[].decimalsinteger

حداکثر رقم بعد از ممیز در amount⁠.

assets[].min_depositstring

حداقل واریز در واحد خود دارایی.

assets[].namestring

assets[].statusstring

activedisabled

next_after_codestringلازم

در صفحه‌ی آخر خالی است.

خطاها

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

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

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

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

502پاسخی رسید که رومو نمی‌تواند به آن معنا بدهد. کمی بعد دوباره بخوانید.

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

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