Ana içeriğe geç

Kullanıcı İşlemlerini Al

Belirli bir kullanıcı için filtreleme seçenekleriyle işlemleri alın.

Endpoint​

GET /v2/users/users/{user_id}/transactions

Headers​

HeaderDeğer
AuthorizationBearer {token}

Yol Parametreleri​

ParametreTipGerekliAçıklama
user_idstringEvetKullanıcının benzersiz tanımlayıcısı

Sorgu Parametreleri​

ParametreTipGerekliAçıklama
pageintegerEvetSayfalama için sayfa numarası
per_pageintegerEvetSayfa başına öğe sayısı
typesinteger[]Hayırİşlem tiplerine göre filtrele (birden fazla olabilir)

Yanıt​

Belirtilen kullanıcı için sayfalı işlem listesini döndürür.

Başarılı Yanıt (200 OK)​

{
    "data": [
        {
            "id": "6985e6fa07aa9b80c33f6a7d",
            "user_id": "6983c9b807aa9b80c33f696d",
            "type": 1,
            "status": 3,
            "environment": 0,
            "internal_id": "698345d9e2cb4cfb988cacb3",
            "external_id": "698345d9e2cb4cfb988cacb3",
            "hash": "0xc34e006659d532a0c8212a8ec624a08cfab3ffbd102936a681ab81e3cf7e0c6d",
            "error": null,
            "message": null,
            "is_api": false,
            "created_at": "2026-02-06T13:04:58.802Z",
            "updated_at": "2026-02-06T13:05:09.911Z",
            "data": {
                "token_id": "698345d9e2cb4cfb988cacb3",
                "quantity": 7,
                "price_id": "6913307ec95e268b239b2d8b",
                "price_amount": 1,
                "price_decimal": 6,
                "price_symbol": "VUSD",
                "price_address": "0xf2d90affe805280c004d0135343f2cbd7c96ce98",
                "seller_address": "0x11Dd160A9e962E8fAc0b3307Ef75Ad4eA3F4d82C",
                "buyer_address": "0x4A096E485281DE1B8bF11A511D39d5B128EF7C4b",
                "total_fee_percentage": 4,
                "total_fee_amount": 0.28
            }
        },
        {
            "id": "6985c19507aa9b80c33f6a18",
            "user_id": "6983c9b807aa9b80c33f696d",
            "type": 6,
            "status": 1,
            "environment": 0,
            "internal_id": null,
            "external_id": "6983383ae2cb4cfb988cacaf",
            "hash": null,
            "error": null,
            "message": null,
            "data": null,
            "is_api": false,
            "created_at": "2026-02-06T10:25:25.83Z",
            "updated_at": "2026-02-06T10:25:25.83Z"
        }
    ],
    "total": 6,
    "page": 1,
    "per_page": 10
}

Yanıt Alanları​

AlanTipAçıklama
dataarrayİşlem nesnelerinin dizisi
totalintegerToplam işlem sayısı
pageintegerMevcut sayfa numarası
per_pageintegerSayfa başına öğe sayısı

İşlem Nesnesi Yapısı​

AlanTipAçıklama
idstringBenzersiz işlem tanımlayıcısı
user_idstringKullanıcı tanımlayıcısı
typeintegerİşlem tipi (aşağıdaki Type enum'a bakın)
statusintegerİşlem durumu (Status enum)
environmentintegerİşlem ortamı (Environment enum)
internal_idstring | nullDahili referans (örn. tamamlandığında satın alma ID'si)
external_idstringHarici referans (örn. token ID)
hashstring | nullBlockchain işlem hash'i
errorstring | nullİşlem başarısız olduysa hata mesajı
messagestring | nullİşlem mesajı
dataobject | nullTipe özel payload - yapı type'a göre değişir (Tipe Göre Veri bölümüne bakın)
is_apibooleanİşlemin API ile oluşturulup oluşturulmadığı
created_atstringOluşturulma zamanı (ISO 8601)
updated_atstringSon güncelleme zamanı (ISO 8601)

Tipe Göre Veri​

data nesnesinin yapısı type'a bağlıdır. Geçerli olmayan durumlarda alanlar atlanır.

Tip 1 - PurchaseOnPrimaryMarket (Birincil Piyasa Satın Alma)​

AlanTipAçıklama
token_idstringToken tanımlayıcısı
quantityintegerSatın alınan miktar
price_idstringPara birimi token ID'si
price_amountnumberBirim fiyat
price_decimalintegerFiyat ondalık basamakları
price_symbolstringFiyat sembolü (örn. VUSD)
price_addressstringPara birimi sözleşme adresi
seller_addressstringSatıcı cüzdan adresi
buyer_addressstringAlıcı cüzdan adresi
total_fee_percentagenumberToplam komisyon yüzdesi (opsiyonel)
total_fee_amountnumberToplam komisyon tutarı (opsiyonel)

Tip 2 - PurchaseOnSecondaryMarket (İkincil Piyasa Satın Alma)​

AlanTipAçıklama
token_idstringToken tanımlayıcısı
deal_idintegerİşlem/listeleme tanımlayıcısı
quantityintegerSatın alınan miktar
price_id, price_amount, price_decimal, price_symbol, price_address-Fiyat bilgisi
seller_addressstringSatıcı cüzdan adresi
buyer_addressstringAlıcı cüzdan adresi
total_buyer_fee_percentage, total_buyer_fee_amountnumberAlıcı komisyonu (opsiyonel)
total_seller_fee_percentage, total_seller_fee_amountnumberSatıcı komisyonu (opsiyonel)

Tip 3 - SellOnSecondaryMarket (İkincil Piyasa Satış)​

AlanTipAçıklama
token_idstringToken tanımlayıcısı
quantityintegerSatılan miktar
amountintegerToplam tutar
price_id, price_amount, price_decimal, price_symbol, price_address-Fiyat bilgisi
total_fee_percentage, total_fee_amountnumberKomisyon (opsiyonel)

Tip 4 - DelistOnSecondaryMarket (İkincil Piyasa Listesinden Çıkarma)​

AlanTipAçıklama
token_idstringToken tanımlayıcısı
deal_idintegerİşlem tanımlayıcısı

Tip 5 - ClaimRent (Kira Talebi)​

AlanTipAçıklama
token_idstringToken tanımlayıcısı
rent_idintegerKira tanımlayıcısı
node_idstringNode tanımlayıcısı
per_price_amount, per_price_decimal, per_price_symbol, per_price_address, per_price_id-Token başına fiyat (opsiyonel)
total_price_amount, total_price_decimal, total_price_symbol, total_price_address, total_price_id-Toplam fiyat (opsiyonel)

Tip 6 - CreateOtcOffer (OTC Teklifi Oluşturma)​

AlanTipAçıklama
token_idstringToken tanımlayıcısı
quantityintegerTeklif edilen miktar
amountintegerToplam tutar
price_id, price_amount, price_decimal, price_symbol, price_address-Fiyat bilgisi
total_fee_percentage, total_fee_amountnumberKomisyon (opsiyonel)

Tip 7 - CancelOtcOffer (OTC Teklifi İptal)​

AlanTipAçıklama
token_idstringToken tanımlayıcısı
deal_idintegerİşlem tanımlayıcısı

Tip 8 - Burn (Token Yakma)​

AlanTipAçıklama
token_idstringToken tanımlayıcısı
received_amountnumberAlınan tutar (opsiyonel)
received_amount_decimalintegerAlınan tutar ondalık basamakları (opsiyonel)
received_amount_symbolstringAlınan tutar sembolü (opsiyonel)
received_amount_addressstringAlınan tutar sözleşme adresi (opsiyonel)

Type (İşlem Tipi)​

DeğerAçıklama
1PurchaseOnPrimaryMarket - Birincil piyasa satın alma
2PurchaseOnSecondaryMarket - İkincil piyasa satın alma
3SellOnSecondaryMarket - İkincil piyasa satış
4DelistOnSecondaryMarket - İkincil piyasa listesinden çıkarma
5ClaimRent - Kira talep etme
6CreateOtcOffer - OTC teklifi oluşturma
7CancelOtcOffer - OTC teklifini iptal etme
8Burn - Token yakma
9PurchaseOnDistributionMarket - Dağıtım piyasasında satın alma

Status (İşlem Durumu)​

DeğerAçıklama
1Started - İşlem başladı
2InProgress - İşlem devam ediyor
3Done - İşlem tamamlandı
4Error - İşlem başarısız

Environment (İşlem Ortamı)​

DeğerAçıklama
0DefaultEnvironment - Varsayılan ortam
1OtcEnvironment - OTC ortamı
2SecondaryMarketEnvironment - İkincil piyasa ortamı

Örnek​

İstek​

curl -X GET "\{\{baseUrl\}\}/v2/users/users/6983c9b807aa9b80c33f696d/transactions?page=1&per_page=10" \
  -H "Authorization: Bearer \{\{token\}\}"

Yanıt​

{
    "data": [
        {
            "id": "6985e6fa07aa9b80c33f6a7d",
            "user_id": "6983c9b807aa9b80c33f696d",
            "type": 1,
            "status": 3,
            "environment": 0,
            "internal_id": "698345d9e2cb4cfb988cacb3",
            "external_id": "698345d9e2cb4cfb988cacb3",
            "hash": "0xc34e006659d532a0c8212a8ec624a08cfab3ffbd102936a681ab81e3cf7e0c6d",
            "error": null,
            "message": null,
            "data": {
                "token_id": "698345d9e2cb4cfb988cacb3",
                "quantity": 7,
                "price_amount": 1,
                "price_decimal": 6,
                "price_symbol": "VUSD",
                "seller_address": "0x11Dd160A9e962E8fAc0b3307Ef75Ad4eA3F4d82C",
                "buyer_address": "0x4A096E485281DE1B8bF11A511D39d5B128EF7C4b",
                "total_fee_amount": 0.28,
                "total_fee_percentage": 4
            },
            "is_api": false,
            "created_at": "2026-02-06T13:04:58.802Z",
            "updated_at": "2026-02-06T13:05:09.911Z"
        },
        {
            "id": "6985c19507aa9b80c33f6a18",
            "user_id": "6983c9b807aa9b80c33f696d",
            "type": 6,
            "status": 1,
            "environment": 0,
            "external_id": "6983383ae2cb4cfb988cacaf",
            "hash": null,
            "error": null,
            "message": null,
            "data": null,
            "is_api": false,
            "created_at": "2026-02-06T10:25:25.83Z",
            "updated_at": "2026-02-06T10:25:25.83Z"
        }
    ],
    "total": 6,
    "page": 1,
    "per_page": 10
}

Hata Yanıtları​

400 Bad Request​

{
    "error": "Geçersiz kullanıcı ID formatı"
}

401 Unauthorized​

{
    "error": "Kimlik doğrulaması gerekli"
}

403 Forbidden​

{
    "error": "Erişim reddedildi"
}

404 Not Found​

{
    "error": "Kullanıcı bulunamadı"
}

500 Internal Server Error​

{
    "error": "İç sunucu hatası"
}