Kullanıcı OTC Gruplarını Listele

Kullanıcının OTC tekliflerini token başına tek satıra indirgenmiş hâlde, en yeni token önce olacak şekilde döndürür. total_quantity, kullanıcının token üzerinde verdiği ve artık zincir onayı beklemeyen her teklifin miktarını toplar (açık, kabul edilmiş, iptal edilmiş ve reddedilmiş teklifler birlikte). Tekliflerin kendileri için Kullanıcı OTC Tekliflerini Listele ucunu kullanın.

Teklifi olmayan kullanıcı 404 değil, boş bir sayfa alır.

Gerekli izin: otc:view

İstek

GET /v2/users/{user_id}/otcs

Parametreler

Ad	Tip	Konum	Açıklama
user_id	string	path	Zorunlu. Kullanıcı ID'si
page	integer	query	Zorunlu. Sayfa numarası, 1'den başlar
per_page	integer	query	Zorunlu. Sayfa başına kayıt, 1–100

Başlıklar

Ad	Açıklama
Authorization	Zorunlu. Bearer <access_token>

Örnek

curl --request GET \
  --url '{{baseUrl}}/v2/users/680c02896d91ca0145cfeb81/otcs?page=1&per_page=10' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

{
  "data": [
    {
      "token_id": "68ae06cfcccf4e8fc19362d1",
      "total_quantity": 30,
      "total_amount": "0",
      "overall_profit": null,
      "source": "otc",
      "token": {
        "name": "Sample Token",
        "symbol": "Sample",
        "image": "https://cdn.example.com/tokens/68ae06cfcccf4e8fc19362d1/cover.png",
        "address": "0x4ecde4b1b0a8f7a5d5c1e0f1a2b3c4d5e6f78387",
        "diamond_address": "0x730d22ae2267fc5b40520605868ddb48c29331a7",
        "status": 6,
        "category_id": "667e9251ca818a2138ed4885",
        "price_symbol": "VUSD",
        "is_external": false,
        "is_open_to_secondary_market": true,
        "is_open_to_otc": true,
        "secondary_market": null,
        "rate_changes": {
          "hourly": null,
          "daily": null,
          "weekly": null,
          "monthly": null,
          "quarterly": null
        }
      }
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 10
}

Yanıt Alanları

Satır, Kullanıcı Varlıklarını Listele ile aynı biçimdedir; bu uçta:

Alan	Tip	Açıklama
data[].token_id	string	Tekliflerin ait olduğu token
data[].total_quantity	integer	Kullanıcının bu token'daki tekliflerinin quantity toplamı (bekleyen teklifler hariç)
data[].total_amount	string	OTC gruplarında hesaplanmaz: her zaman "0"
data[].overall_profit	string | null	OTC gruplarında hesaplanmaz: her zaman null
data[].source	string	Her zaman otc
data[].token	object	Token: name, symbol (token'ın zincir üstü adı), image, address, diamond_address, status, category_id, price_symbol, is_external, is_open_to_secondary_market, is_open_to_otc. Bu uçta secondary_market null'dır ve her rate_changes penceresi null'dır
total	integer	Kullanıcının teklifi bulunan token sayısı
page	integer	İstenen sayfa
per_page	integer	İstenen sayfa boyutu

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama başarısız (page, per_page) — details alanına bakın
500	10000	Beklenmeyen sunucu hatası

Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.