Kullanıcı İşlemlerini Getir

Bir kullanıcının işlemlerini en yeniden eskiye listeler; isteğe bağlı olarak belirli işlem tipleriyle daraltılabilir. Kullanıcı tarafındaki her yazma işlemi (alım, satış, ilandan kaldırma, OTC satış ve iptal, kira talebi, yakma, para çekme) bu satırlardan birini oluşturur. Tek bir transaction_id'yi takip etmek için bu listeyi sayfalamak yerine Kullanıcı İşlemini Getir ile doğrudan okuyun.

Gerekli izin: user:view

İstek

GET /v2/users/{user_id}/transactions

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
types	integer	query	İsteğe bağlı, tekrarlanabilir. Yalnızca bu tipleri döndürür, ör. types=1&types=2

Başlıklar

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

Örnek

curl --request GET \
  --url '{{baseUrl}}/v2/users/6a87455ad5f439809d488ac3/transactions?page=1&per_page=10&types=1&types=10' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

{
  "data": [
    {
      "id": "6985e6fa07aa9b80c33f6a7d",
      "user_id": "6a87455ad5f439809d488ac3",
      "type": 1,
      "status": 3,
      "environment": 0,
      "internal_id": "698345d9e2cb4cfb988cacb3",
      "wallet_id": "6a8754e187be1d0e22aa6d83",
      "external_id": "",
      "hash": "0xc34e006659d532a0c8212a8ec624a08cfab3ffbd102936a681ab81e3cf7e0c6d",
      "error": null,
      "message": null,
      "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",
        "wallet_id": "6a8754e187be1d0e22aa6d83",
        "total_fee_percentage": "4",
        "total_fee_amount": "0.28"
      },
      "is_api": true,
      "created_at": "2026-08-23T13:04:58.802Z",
      "updated_at": "2026-08-23T13:05:09.911Z"
    },
    {
      "id": "6a8b5e13f9129816a6cc7a12",
      "user_id": "6a87455ad5f439809d488ac3",
      "type": 10,
      "status": 1,
      "environment": 0,
      "internal_id": "",
      "wallet_id": "6a8754e187be1d0e22aa6d83",
      "external_id": "",
      "hash": null,
      "error": null,
      "message": null,
      "data": {
        "address": "0x4A096E485281DE1B8bF11A511D39d5B128EF7C4b",
        "amount": "10.5",
        "currency_token_id": "6913307ec95e268b239b2d8b"
      },
      "is_api": true,
      "created_at": "2026-08-23T17:43:31.004Z",
      "updated_at": "2026-08-23T17:43:31.004Z"
    }
  ],
  "total": 2,
  "page": 1,
  "per_page": 10
}

Yanıt Alanları

Alan	Tip	Açıklama
data	array	Bu sayfadaki işlemler. Kullanıcının işlemi yoksa boş dizi (bilinmeyen bir kullanıcı da boş sayfa döndürür)
total	integer	Filtreye uyan işlem sayısı
page	integer	İstenen sayfa
per_page	integer	İstenen sayfa boyutu

Her işlem:

Alan	Tip	Açıklama
id	string	İşlem ID'si
user_id	string	İşlemin ait olduğu kullanıcı
type	integer	İşlemin ne yaptığı, bkz. Tip
status	integer	Bkz. Durum
environment	integer	Bkz. Ortam
internal_id	string	İşlemin üzerinde çalıştığı kayıt (ilan, OTC teklifi, token). Yoksa boş string
wallet_id	string	İşlemin üzerinde çalıştığı ve imzaladığı cüzdan. Cüzdan belirtmeyen işlemlerde boş string
external_id	string	Varsa custody tarafındaki referans
hash	string | null	Zincir üstü işlem hash'i; Done olunca dolar
error	string | null	Hata sebebi; Error olunca dolar
message	string | null	Verilmişse okunabilir açıklama
data	object	Tipe özel veri, bkz. Tipe göre veri. İşlemin verisi yoksa alan hiç gelmez
is_api	boolean	Aksiyonun partner API üzerinden gelip gelmediği
created_at	string	ISO 8601 oluşturulma zamanı
updated_at	string	ISO 8601 son değişiklik zamanı

Tip (İşlem Tipi)

Değer	Ad	Oluşturan
1	PurchaseOnPrimaryMarket	Buy On Primary Market
2	PurchaseOnSecondaryMarket	Buy On Secondary Market
3	SellOnSecondaryMarket	Sell On Secondary Market
4	DelistOnSecondaryMarket	Delist
5	ClaimRent	Claim Rent
6	CreateOtcOffer	Sell On OTC
7	CancelOtcOffer	Cancel OTC Deal
8	Burn	Burn
9	PurchaseOnDistributionMarket	Dağıtım piyasası alımı
10	Withdraw	Para Çekme

Durum

Değer	Ad	Anlamı
1	Started	Kaydedildi, henüz işleme alınmadı
2	InProgress	İşleniyor / zincire gönderildi
3	Done	Sonuçlandı; hash dolu
4	Error	Başarısız; error dolu

Ortam

Değer	Ad
0	Varsayılan
1	OTC
2	İkincil piyasa

Tipe göre veri

data içindeki tutar, fiyat ve ücret değerleri ondalık string'tir; adetler, ilan/kira ID'leri ve ondalık basamaklar sayıdır. İsteğe bağlı anahtarlar ayarlanmadıysa hiç gelmez.

Tip 1 — PurchaseOnPrimaryMarket

Alan	Tip	Açıklama
token_id	string	Alınan token
quantity	integer	Alınan adet
price_id	string	Fiyatın para birimi token'ı
price_amount	string	Birim fiyat
price_decimal	integer	Fiyat para biriminin ondalık basamağı
price_symbol	string	Fiyat para biriminin sembolü
price_address	string	Fiyat para biriminin kontrat adresi
seller_address	string	Satıcı adresi
buyer_address	string	Alıcı cüzdanının adresi
wallet_id	string	İsteğe bağlı. Token'ların yazılacağı alıcı cüzdanı
total_fee_percentage	string	İsteğe bağlı. Toplam ücret oranı
total_fee_amount	string	İsteğe bağlı. Toplam ücret tutarı

Tip 2 — PurchaseOnSecondaryMarket

Alan	Tip	Açıklama
token_id	string	Alınan token
deal_id	integer	Alınan ilan
quantity	integer	Alınan adet
price_amount, price_decimal, price_symbol, price_address	—	Fiyat, tip 1'deki gibi
seller_address	string	Satıcı adresi
buyer_address	string	Alıcı cüzdanının adresi
wallet_id	string	İsteğe bağlı. Token'ların yazılacağı alıcı cüzdanı
total_buyer_fee_percentage, total_buyer_fee_amount	string	İsteğe bağlı. Alıcı ücreti
total_seller_fee_percentage, total_seller_fee_amount	string	İsteğe bağlı. Satıcı ücreti

Tip 3 — SellOnSecondaryMarket / Tip 6 — CreateOtcOffer

Alan	Tip	Açıklama
token_id	string	Satılan token
quantity	integer	İlana çıkan / teklif edilen adet
amount	integer	Toplam tutar
price_id, price_amount, price_decimal, price_symbol, price_address	—	Fiyat, tip 1'deki gibi
wallet_id	string	İsteğe bağlı. Token'ların satıldığı satıcı cüzdanı
total_fee_percentage, total_fee_amount	string	İsteğe bağlı. Ücret

Tip 4 — DelistOnSecondaryMarket / Tip 7 — CancelOtcOffer

Alan	Tip	Açıklama
token_id	string	Token
deal_id	integer	İptal edilen ilan / teklif

Tip 5 — ClaimRent

Alan	Tip	Açıklama
token_id	string	Token
rent_id	integer	Talep edilen kira
node_id	string	Kirayı ödeyen düğüm
per_price_amount, per_price_decimal, per_price_symbol, per_price_address, per_price_id	—	İsteğe bağlı. Token başına kira
total_price_amount, total_price_decimal, total_price_symbol, total_price_address, total_price_id	—	İsteğe bağlı. Toplam kira

Tip 8 — Burn

Alan	Tip	Açıklama
token_id	string	Yakılan token
received_amount	string	İsteğe bağlı. Alınan tutar
received_amount_decimal	integer	İsteğe bağlı. Ondalık basamağı
received_amount_symbol	string	İsteğe bağlı. Sembolü
received_amount_address	string	İsteğe bağlı. Kontrat adresi

Tip 10 — Withdraw

Alan	Tip	Açıklama
address	string	Hedef adres
amount	string	Gönderilen tutar
currency_token_id	string	Gönderilen para birimi token'ı. Native coin çekiminde gelmez

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama hatası (page / per_page eksik ya da aralık dışı) — details alanına bakın
400	10016	user_id geçerli bir ID değil

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