🔎Search Transactions

Search all your transactions , deposits and withdrawals, with filtering support

API Endpoint

Request Headers:

Authorization: Bearer <access_token>

Content-Type: application/json

Request Body

Transactions can be filtered by a wallets, and apply an OR filter to filter matching transactions by fields whildcards of txID, source, destination, tag, type and action.

{
    "page": 1,        // optional - if not present, default 1
    "pageSize": 20,   // optional - if not present, default 10
    
    "wallet": "<wallet_uuid>" // optional - and filter
    
    // with an OR filter transactions, matching fields: 
    // - txID, tron transaction hash 
    // - wallet, wallet UUID
    // - tag, the wallet(s) group tag 
    // - source address
    // - destination address
    // - type as 'TRX' for tron, 'TRC20' for USDT
    // - action as 'sent' or 'received'
    "or": "<value>" 
}

Success Response By default all search results are paged, with 10 items per page.

You can specify in your request the page number and number of items per page. Find in response, which page you are, if more pages are availabe (nextPage: true), total count for all items without paging and the total found for items count in this page.

Example Below:

{
    "success": {
        "message": "Done",
        "data": [
            {
                "txRef": "f2f5...1a1aa8",
                "action": "sent",
                "address": "TNQGn...boUi2N",
                "amount": "10000000",
                "availableBandwidthPoints": 261,
                "availableEnergy": 0,
                "createdAt": 1696856682072,
                "destination": "TPx4K...G4bZ1",
                "feeSUN": 5881440,
                "requiredBandwidthPoints": 345,
                "requiredEnergy": 13182,
                "source": "TNQ...oUi2N",
                "sunCostForBandwidth": 345000,
                "sunCostForEnergy": 5536440,
                "tag": "Master",
                "timestamp": 1696856681664,
                "tokenAddress": "TMhkJ...L5sz",
                "tokenDecimals": "6",
                "txID": "6ca6f5...7bf808c8",
                "type": "TRC20",
                "username": "[email protected]",
                "wallet": "6984...0cba",
                "mailed": 1
            },
            {
                "txRef": "f13...5c7805",
                "action": "received",
                "address": "TPx4...Z1",
                "amount": "10000000",
                "destination": "TPx4...4bZ1",
                "source": "TNQ...Ui2N",
                "tag": "xpay-credits: +10 🪙",
                "timestamp": 1696856681664,
                "txID": "6ca6...808c8",
                "type": "TRC20",
                "username": "[email protected]",
                "wallet": "4199...23D6",
                "credited": 1
            },
            {
                "txRef": "592d...740d",
                "action": "sent",
                "address": "TNQ...i2N",
                "amount": "10000000",
                "availableBandwidthPoints": 257,
                "availableEnergy": 0,
                "createdAt": 1696855821267,
                "destination": "TPx...4bZ1",
                "feeSUN": 5881440,
                "requiredBandwidthPoints": 345,
                "requiredEnergy": 13182,
                "source": "TNQG...Ui2N",
                "sunCostForBandwidth": 345000,
                "sunCostForEnergy": 5536440,
                "tag": "Master",
                "timestamp": 1696855820782,
                "tokenAddress": "TMhkJ...L5sz",
                "tokenDecimals": "6",
                "txID": "ca771...26be",
                "type": "TRC20",
                "username": "[email protected]",
                "wallet": "698...0cba",
                "mailed": 1
            },
            {
                "txRef": "d6e62...fdde5",
                "action": "received",
                "address": "TPx4...4bZ1",
                "amount": "10000000",
                "destination": "TPx4...G4bZ1",
                "source": "TNQG...Ui2N",
                "tag": "xpay-credits: +10 🪙",
                "timestamp": 1696855820782,
                "txID": "ca771...826be",
                "type": "TRC20",
                "username": "[email protected]",
                "wallet": "4199...3D6",
                "credited": 1
            },
            {
                "txRef": "fe05...df0ea",
                "action": "sent",
                "address": "TNQG...Ui2N",
                "amount": "10000000",
                "availableBandwidthPoints": 600,
                "availableEnergy": 0,
                "createdAt": 1696855378585,
                "destination": "TPx...bZ1",
                "feeSUN": 5536440,
                "requiredBandwidthPoints": 345,
                "requiredEnergy": 13182,
                "source": "TNQ...i2N",
                "sunCostForBandwidth": 0,
                "sunCostForEnergy": 5536440,
                "tag": "Master",
                "timestamp": 1696855378086,
                "tokenAddress": "TMhk...L5sz",
                "tokenDecimals": "6",
                "txID": "1939...e212",
                "type": "TRC20",
                "username": "[email protected]",
                "wallet": "6984da12-ca05-4712-b63c-63f3d5460cba",
                "mailed": 1
            },
            {
                "txRef": "1ec9a...d0ce6",
                "action": "received",
                "address": "TPx4...4bZ1",
                "amount": "10000000",
                "destination": "TPx...4bZ1",
                "source": "TNQ...oUi2N",
                "tag": "xpay-credits: +10 🪙",
                "timestamp": 1696855378086,
                "txID": "193...e212",
                "type": "TRC20",
                "username": "[email protected]",
                "wallet": "419...3D6",
                "credited": 1
            },
            {
                "txRef": "5f5...637e",
                "action": "sent",
                "address": "TNQ...i2N",
                "amount": "10000000",
                "availableBandwidthPoints": 154,
                "availableEnergy": 0,
                "createdAt": 1696437043211,
                "destination": "TPx...bZ1",
                "feeSUN": 5881440,
                "requiredBandwidthPoints": 345,
                "requiredEnergy": 13182,
                "source": "TNQ...2N",
                "sunCostForBandwidth": 345000,
                "sunCostForEnergy": 5536440,
                "tag": "Master",
                "timestamp": 1696437042738,
                "tokenAddress": "TMh...L5sz",
                "tokenDecimals": "6",
                "txID": "7709f1...307a5",
                "type": "TRC20",
                "username": "[email protected]",
                "wallet": "698...cba",
                "mailed": 1
            },
            {
                "txRef": "995d228...ff2bc",
                "action": "sent",
                "address": "TNQGnb...rfsboUi2N",
                "amount": "12000000",
                "availableBandwidthPoints": 439,
                "availableEnergy": 0,
                "createdAt": 1696426917221,
                "destination": "TPx4K4...Eu7G4bZ1",
                "feeSUN": 5536440,
                "requiredBandwidthPoints": 345,
                "requiredEnergy": 13182,
                "source": "TNQ...2N",
                "sunCostForBandwidth": 0,
                "sunCostForEnergy": 5536440,
                "tag": "Master",
                "timestamp": 1696426916571,
                "tokenAddress": "TMhkJ...RL5sz",
                "tokenDecimals": "6",
                "txID": "44a23...acadb2",
                "type": "TRC20",
                "username": "[email protected]",
                "wallet": "6984...0cba",
                "mailed": 1
            },
            {
                "txRef": "bed3...a4b7f",
                "action": "sent",
                "address": "TNQ...oUi2N",
                "amount": 5000000,
                "availableBandwidthPoints": 143,
                "availableEnergy": 0,
                "createAt": 1696372081847,
                "destination": "TVBG...TbDi",
                "feeSUN": 268000,
                "requiredBandwidthPoints": 268,
                "requiredEnergy": 0,
                "source": "TNQ..i2N",
                "sunCostForBandwidth": 268000,
                "sunCostForEnergy": 0,
                "tag": "Master",
                "timestamp": 1696372080000,
                "txID": "1450...fb985",
                "type": "TRX",
                "username": "[email protected]",
                "wallet": "6984da...460cba",
                "mailed": 1
            },
            {
                "txRef": "e38ff5027b2...0ad6e",
                "action": "received",
                "address": "TNQGnbM...Ui2N",
                "amount": "24000000",
                "destination": "TNQGnb...Ui2N",
                "source": "TVBG..TbDi",
                "tag": "Master",
                "timestamp": 1696371478395,
                "txID": "8506f9...2bd8",
                "type": "TRC20",
                "username": "[email protected]",
                "wallet": "698...cba",
                "mailed": 1
            }
        ]
    },
    "page": 1,
    "pageSize": 10,
    "foundCount": 10,
    "totalCount": 25,
    "nextPage": true,
    "uuid": "5c7b6dfb-cebc-4d12-8de9-b66d05980ee1"
}

curl 'https://apis.xpay.stream/client/transactions/find' \
  -H 'Authorization: Bearer <access_token>'         \
  -H 'Content-Type: application/json'               \
  --data-raw '{}'

// npm i cross-fetch
const fetch = require("cross-fetch");

const API_URL = "https://apis.xpay.stream/client/transactions/find";

const method = "POST";

const headers = { 
    "Content-Type": "application/json",
    "Authorization": "Bearer <access_token>"
};

const body = JSON.stringify({
    page: 1,
    pageSize: 20,
    wallet: "<wallet_uuid>"
});

fetch(API_URL, { headers, body, method })
.then(async res =>  await res.json())
.then(result => {
    if(result.error)
        console.log("Wallets Search Error", result);
    if(result.success)
        console.log("Wallet Searched", result);
})
.catch((err) => {
    console.error("Wallet Search API Exception", err);
});

PreviousBroadcast Transaction NextNotifications

Last updated 10 months ago