Kullanıcının Token İlanlarını Listele
Kullanıcının bir token üzerindeki kendi ikincil piyasa ilanlarını en yeniden eskiye, ilan başına bir satır olarak döndürür. Hâlâ zincir onayı bekleyen ilanlar listelenmez; açık, tamamlanmış ve iptal edilmiş olanlar listelenir. Açık bir ilanı (status = 0) ilandan kaldırmak için onun deal_id değerini kullanın.
Gerekli izin: secondary-market:view
İstek
GET /v2/users/{user_id}/secondary-markets/tokens/{token_id}
Parametreler
| Ad | Tip | Konum | Açıklama |
|---|---|---|---|
user_id | string | path | Zorunlu. Kullanıcı ID'si |
token_id | string | path | Zorunlu. Token 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/secondary-markets/tokens/68ae06cfcccf4e8fc19362d1?page=1&per_page=10' \
--header 'Authorization: Bearer <access_token>'
Yanıt
{
"data": [
{
"id": "6913b20e55654191dede3801",
"token_id": "68ae06cfcccf4e8fc19362d1",
"user_id": "680c02896d91ca0145cfeb81",
"deal_id": 12,
"quantity": 10,
"price": {
"amount": "12",
"decimal": 6,
"symbol": "VUSD",
"address": "0xf2d90affe805280c004d0135343f2cbd7c96ce98"
},
"status": 0,
"created_at": "2026-11-09T09:40:03Z",
"updated_at": "2026-11-09T09:41:10Z"
}
],
"total": 1,
"page": 1,
"per_page": 10
}
Yanıt Alanları
| Alan | Tip | Açıklama |
|---|---|---|
data[].id | string | İlan ID'si |
data[].token_id | string | İlandaki token |
data[].user_id | string | Satıcı (bu kullanıcı) |
data[].deal_id | integer | İlanın zincir üstü anlaşma ID'si |
data[].quantity | integer | İlandaki tam token sayısı |
data[].price | object | Birim fiyat: ödeme para biriminin amount (ondalık string), decimal, symbol, address değerleri |
data[].status | integer | 0 açık, 1 tamamlandı (satıldı), 2 iptal edildi |
data[].created_at | string | İlanın kaydedildiği zaman (RFC 3339) |
data[].updated_at | string | Son değişiklik (RFC 3339) |
total | integer | Eşleşen ilan 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.