🔎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@test.com",
"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@test.com",
"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@test.com",
"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@test.com",
"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@test.com",
"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@test.com",
"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@test.com",
"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@test.com",
"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@test.com",
"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@test.com",
"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);
});Last updated