İşlem Geçmişi

Hesabınızın kendi işlemlerini en yeniden başlayarak sayfalama ve durum filtreleme desteği ile döndürür. Yalnızca API anahtarının ait olduğu hesap tarafından oluşturulan işlemler listelenir. Bakiye yüklemeleri, referans ödülleri ve ödemeler sipariş değildir ve listelenmez.

POST /v1/transactions/history

İstek

Tüm parametreler isteğe bağlıdır. Parametreler belirtilmezse, 10 öğe ile ilk sayfa döndürülür. Bilinmeyen bir status, 1'den küçük bir page veya 1–50 aralığı dışındaki bir per_page 2 koduyla reddedilir. 1–26 karakterlik bir dize olmayan user_subscription_id de aynı şekilde reddedilir.

İstek Parametreleri

Alan	Tip	Gerekli	Açıklama
page	integer	Hayır	Sayfa numarası (varsayılan: 1, minimum: 1)
per_page	integer	Hayır	Sayfa başına öğe sayısı (varsayılan: 10, maksimum: 50)
status	string	Hayır	İşlem durumuna göre filtrele: new, pending, success veya failed (durum listesine bakın)
user_subscription_id	string	Hayır	Yalnızca aboneliklerinizden birinin satın aldığı işlemler: Abonelik geçmişi ve Abonelik başlatma yanıtlarındaki id değeri. Size ait olmayan bir aboneliğin id değeri boş bir sayfa döndürür

Bash

#!/bin/bash
API_TOKEN="your_api_token"
API_SECRET="your_api_secret"
REQUEST_BODY='{
  "page": 1,
  "per_page": 10,
  "status": "success"
}'

# İmza hesaplama
SIGNATURE=$(echo -n "${REQUEST_BODY}${API_SECRET}" | sha256sum | cut -d' ' -f1)

# API isteği yürütme
curl -X POST "https://api.trxup.com/v1/transactions/history" \
  -H "Authorization: Bearer ${API_TOKEN}" \
  -H "X-Signature: ${SIGNATURE}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}"

Node.js

const crypto = require('crypto');
const axios = require('axios');

const apiToken = 'your_api_token';
const apiSecret = 'your_api_secret';
const requestBody = JSON.stringify({
  page: 1,
  per_page: 10,
  status: 'success'
});

// İmza hesaplama
const signature = crypto
  .createHash('sha256')
  .update(requestBody + apiSecret)
  .digest('hex');

// API isteği yürütme
axios({
  method: 'post',
  url: 'https://api.trxup.com/v1/transactions/history',
  headers: {
    'Authorization': `Bearer ${apiToken}`,
    'X-Signature': signature,
    'Content-Type': 'application/json'
  },
  data: requestBody
})
.then(response => console.log(response.data))
.catch(error => console.error(error));

PHP

<?php
$apiToken = 'your_api_token';
$apiSecret = 'your_api_secret';
$requestBody = json_encode([
  'page' => 1,
  'per_page' => 10,
  'status' => 'success'
]);

// İmza hesaplama
$signature = hash('sha256', $requestBody . $apiSecret);

// API isteği yürütme
$ch = curl_init('https://api.trxup.com/v1/transactions/history');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $requestBody);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  'Authorization: Bearer ' . $apiToken,
  'X-Signature: ' . $signature,
  'Content-Type: application/json'
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

Python

import hashlib
import json
import requests

api_token = 'your_api_token'
api_secret = 'your_api_secret'
request_body = json.dumps({
  'page': 1,
  'per_page': 10,
  'status': 'success'
})

# İmza hesaplama
signature = hashlib.sha256((request_body + api_secret).encode()).hexdigest()

# API isteği yürütme
headers = {
  'Authorization': f'Bearer {api_token}',
  'X-Signature': signature,
  'Content-Type': 'application/json'
}

response = requests.post(
  'https://api.trxup.com/v1/transactions/history',
  headers=headers,
  data=request_body
)

print(response.json())

Parametresiz İstek Örneği

Bash

#!/bin/bash
API_TOKEN="your_api_token"
API_SECRET="your_api_secret"
REQUEST_BODY='{}'

# İmza hesaplama
SIGNATURE=$(echo -n "${REQUEST_BODY}${API_SECRET}" | sha256sum | cut -d' ' -f1)

# API isteği yürütme
curl -X POST "https://api.trxup.com/v1/transactions/history" \
  -H "Authorization: Bearer ${API_TOKEN}" \
  -H "X-Signature: ${SIGNATURE}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}"

Yanıt

Yanıt, hesabın işlemlerinden bir sayfayı sayfalama bilgileri ile içerir. Her öğe, İşlem Durumunu Kontrol Et metodunun aynı id için döndürdüğü alanların tam olarak aynısını içerir.

Birden fazla kaynağı aynı anda satın alan bir işlem (örneğin enerji ve bant genişliği birlikte) tek bir öğedir ve amount değeri bu işlem için tahsil edilen toplam tutardır. Bu işlemin service değeri "energy" olur ve params.amounts satın alınan her kaynağı listeler.

Yanıt Alanları

Alan	Tip	Açıklama
code	integer	Yanıt kodu (0 = başarı)
request_id	string	Benzersiz istek tanımlayıcısı
result	object	Yanıt verileri
result.page	integer	Mevcut sayfa
result.per_page	integer	Sayfa başına öğe sayısı
result.total	integer	Filtreyle eşleşen toplam işlem sayısı
result.items	array	İşlem listesi, en yeniden başlayarak
result.items[].id	string	Dahili işlem kimliği
result.items[].created_at	string	Oluşturma zaman damgası (ISO 8601 formatı)
result.items[].status	string	İşlem durumu (durum listesine bakın)
result.items[].external_id	string|null	Dış işlem kimliği (sağlanmışsa)
result.items[].service	string	Hizmet türü: "energy", "bandwidth" veya "activate_address"
result.items[].params	object|null	Orijinal istek parametreleri
result.items[].amount	string	TRX cinsinden işlem tutarı
result.items[].hash	string|null	İşlem hash'i; yalnızca status değeri success olduğunda bulunur

Yanıt Örneği

Parametresiz isteğe yanıt:

{
  "code": 0,
  "request_id": "64daeda7-15e4-4bcf-ae60-c94867af66d8",
  "result": {
    "page": 1,
    "per_page": 10,
    "total": 3,
    "items": [
      {
        "id": "01M52FEER5JVJ16QNSVX75700Q",
        "created_at": "2026-10-01T12:02:00+00:00",
        "status": "new",
        "external_id": null,
        "service": "energy",
        "params": {
          "address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
          "amounts": {
            "energy": 65000
          },
          "duration": 1
        },
        "amount": "3.58"
      },
      {
        "id": "01M52FEEQT9TGZCHG1732ARRDN",
        "created_at": "2026-10-01T12:01:00+00:00",
        "status": "failed",
        "external_id": "hist-energy",
        "service": "energy",
        "params": {
          "address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
          "amounts": {
            "energy": 65000
          },
          "duration": 1
        },
        "amount": "3.58"
      },
      {
        "id": "01M52FEEPEY6V1SBAMCDMA4GTG",
        "created_at": "2026-10-01T12:00:00+00:00",
        "status": "success",
        "external_id": "hist-bundle",
        "service": "energy",
        "params": {
          "address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
          "amounts": {
            "energy": 65000,
            "bandwidth": 5000
          },
          "duration": 1
        },
        "amount": "3.64",
        "hash": "aa11bb22cc33dd44ee55ff6600112233445566778899aabbccddeeff00112233"
      }
    ]
  }
}

Olası Hatalar

Hata Kodu	Key	Açıklama
1	auth	Kimlik doğrulama hatası (geçersiz token veya imza)
2	invalid_service_or_params	Geçersiz servis veya parametreler
500	internal_server_error	Sunucu iç hatası