İkincil Piyasaları Listele
En az bir açık ikincil piyasa ilanı bulunan her token'ı, token başına bir satır olarak, en ucuzdan (en düşük ilan fiyatına göre) başlayarak döndürür. Her satır token'ın açık ilanlarını toplar ve token'ın kendisini taşır. Bir satırın arkasındaki ilanlar için Token İlanlarını Listele, tek bir token'ın satırı için Token İkincil Piyasa Özetini Getir ucunu kullanın.
Hiçbir şeyin ilanda olmadığı bir piyasa hata değil, boş bir sayfa döndürür.
Gerekli izin: secondary-market:view
İstek
GET /v2/users/secondary-markets
Parametreler
| Ad | Tip | Konum | Açıklama |
|---|---|---|---|
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/secondary-markets?page=1&per_page=10' \
--header 'Authorization: Bearer <access_token>'
Yanıt
{
"data": [
{
"token_id": "68ae06cfcccf4e8fc19362d1",
"token": {
"id": "68ae06cfcccf4e8fc19362d1",
"category_id": "667e9251ca818a2138ed4885",
"origin": 0,
"standard": 0,
"node_id": "665ae536a6392b75cfd40352",
"node_name": "",
"status": 6,
"is_open_to_secondary_market": true,
"is_external": false,
"name": "Sample Token",
"token_name": "Sample",
"token_symbol": "STK",
"value": {
"token_price": {
"amount": "1.12",
"decimal": 6,
"symbol": "VUSD",
"address": "0xf2d90affe805280c004d0135343f2cbd7c96ce98"
}
},
"hourly_rate_change": null,
"daily_rate_change": null,
"weekly_rate_change": null,
"monthly_rate_change": null,
"quarterly_rate_change": null
},
"total_supply": 25,
"total_sold_supply": 0,
"min_price": "1.2",
"max_price": "1.5"
}
],
"total": 1,
"page": 1,
"per_page": 10
}
Yukarıdaki token nesnesi kısaltılmıştır; tam biçimi Token'ı Getir ile aynıdır.
Yanıt Alanları
| Alan | Tip | Açıklama |
|---|---|---|
data[].token_id | string | Satırın ait olduğu token |
data[].token | object | Token'ı Getir biçimindeki token. Bu uçta node_name boştur ve *_rate_change pencereleri null'dır |
data[].total_supply | integer | Token'ın açık ilanlarının quantity toplamı |
data[].total_sold_supply | integer | Bu ilanlarda satılan miktarın toplamı |
data[].min_price | string | Açık ilanlar arasındaki en düşük birim fiyat |
data[].max_price | string | Açık ilanlar arasındaki en yüksek birim fiyat |
total | integer | Açık ilanı 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.