Get All Wallet Transactions

curl --request GET \
  --url https://api-production.fossapay.com/api/v1/wallets/crypto/{walletId}/transactions \
  --header 'x-api-key: <x-api-key>'

import requests

url = "https://api-production.fossapay.com/api/v1/wallets/crypto/{walletId}/transactions"

headers = {"x-api-key": "<x-api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<x-api-key>'}};

fetch('https://api-production.fossapay.com/api/v1/wallets/crypto/{walletId}/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-production.fossapay.com/api/v1/wallets/crypto/{walletId}/transactions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api-production.fossapay.com/api/v1/wallets/crypto/{walletId}/transactions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<x-api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api-production.fossapay.com/api/v1/wallets/crypto/{walletId}/transactions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<x-api-key>'

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "statusCode": 200,
  "message": "Wallet transactions retrieved successfully",
  "data": {
    "transactions": [
      {
        "id": "9495d974-4807-4c44-bd01-f5a69283aecc",
        "reference": "PTY_CRYPTO_16TY0WY7MM717C9",
        "externalReference": "76c230a2-dcbd-4b40-a671-7db8d055d1c6",
        "transactionType": "deposit",
        "status": "failed",
        "amountInCrypto": "10.00000000",
        "tokenSymbol": "usdxm",
        "tokenAddress": "z23BZbAiFRb6u5***64XjZPUud6dP6y2ZuKoYSM4LCY",
        "tokenDecimals": 6,
        "senderAddress": "YcnysYh3Y***PxkazFyiTx76Upv12iP4sNGeHA2H4z2",
        "recipientAddress": "8aQ3Y97fxiX26P***kc3keoQEz5MtWBCVk4pEx96Sqeb",
        "transactionHash": null,
        "explorerLink": null,
        "blockchain": "solana",
        "sourceWalletAddress": "YcnysYh3Y***PxkazFyiTx76Upv12iP4sNGeHA2H4z2",
        "recipientWalletAddress": "8aQ3Y97fxiX26P***kc3keoQEz5MtWBCVk4pEx96Sqeb",
        "sourceWalletId": null,
        "recipientWalletId": null,
        "createdAt": "2026-01-08T00:43:44+01:00",
        "updatedAt": "2026-01-08T00:43:56+01:00"
      },
      {
        "id": "85503565-cb04-4ba7-abfb-b75193553086",
        "reference": "PTY_CRYPTO_NWC3GZ6832M9VFQ",
        "externalReference": "58fdb6f8-9925-4982-a516-95aabf4a22d3",
        "transactionType": "deposit",
        "status": "failed",
        "amountInCrypto": "10.00000000",
        "tokenSymbol": "usdxm",
        "tokenAddress": "z23BZbAiFRb6u5***64XjZPUud6dP6y2ZuKoYSM4LCY",
        "tokenDecimals": 6,
        "senderAddress": "YcnysYh3Y***PxkazFyiTx76Upv12iP4sNGeHA2H4z2",
        "recipientAddress": "8aQ3Y97fxiX26P***kc3keoQEz5MtWBCVk4pEx96Sqeb",
        "transactionHash": null,
        "explorerLink": null,
        "blockchain": "solana",
        "sourceWalletAddress": "YcnysYh3Y***PxkazFyiTx76Upv12iP4sNGeHA2H4z2",
        "recipientWalletAddress": "8aQ3Y97fxiX26P***kc3keoQEz5MtWBCVk4pEx96Sqeb",
        "sourceWalletId": null,
        "recipientWalletId": null,
        "createdAt": "2026-01-08T00:38:24+01:00",
        "updatedAt": "2026-01-08T00:38:39+01:00"
      }
    ],
    "pagination": {
      "currentPage": 1,
      "totalPages": 1,
      "totalItems": 2,
      "itemsPerPage": 10,
      "hasNextPage": false,
      "hasPrevPage": false
    }
  }
}

GET

api

wallets

crypto

{walletId}

transactions

Get All Wallet Transactions

curl --request GET \
  --url https://api-production.fossapay.com/api/v1/wallets/crypto/{walletId}/transactions \
  --header 'x-api-key: <x-api-key>'

import requests

url = "https://api-production.fossapay.com/api/v1/wallets/crypto/{walletId}/transactions"

headers = {"x-api-key": "<x-api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<x-api-key>'}};

fetch('https://api-production.fossapay.com/api/v1/wallets/crypto/{walletId}/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-production.fossapay.com/api/v1/wallets/crypto/{walletId}/transactions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api-production.fossapay.com/api/v1/wallets/crypto/{walletId}/transactions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<x-api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api-production.fossapay.com/api/v1/wallets/crypto/{walletId}/transactions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<x-api-key>'

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "statusCode": 200,
  "message": "Wallet transactions retrieved successfully",
  "data": {
    "transactions": [
      {
        "id": "9495d974-4807-4c44-bd01-f5a69283aecc",
        "reference": "PTY_CRYPTO_16TY0WY7MM717C9",
        "externalReference": "76c230a2-dcbd-4b40-a671-7db8d055d1c6",
        "transactionType": "deposit",
        "status": "failed",
        "amountInCrypto": "10.00000000",
        "tokenSymbol": "usdxm",
        "tokenAddress": "z23BZbAiFRb6u5***64XjZPUud6dP6y2ZuKoYSM4LCY",
        "tokenDecimals": 6,
        "senderAddress": "YcnysYh3Y***PxkazFyiTx76Upv12iP4sNGeHA2H4z2",
        "recipientAddress": "8aQ3Y97fxiX26P***kc3keoQEz5MtWBCVk4pEx96Sqeb",
        "transactionHash": null,
        "explorerLink": null,
        "blockchain": "solana",
        "sourceWalletAddress": "YcnysYh3Y***PxkazFyiTx76Upv12iP4sNGeHA2H4z2",
        "recipientWalletAddress": "8aQ3Y97fxiX26P***kc3keoQEz5MtWBCVk4pEx96Sqeb",
        "sourceWalletId": null,
        "recipientWalletId": null,
        "createdAt": "2026-01-08T00:43:44+01:00",
        "updatedAt": "2026-01-08T00:43:56+01:00"
      },
      {
        "id": "85503565-cb04-4ba7-abfb-b75193553086",
        "reference": "PTY_CRYPTO_NWC3GZ6832M9VFQ",
        "externalReference": "58fdb6f8-9925-4982-a516-95aabf4a22d3",
        "transactionType": "deposit",
        "status": "failed",
        "amountInCrypto": "10.00000000",
        "tokenSymbol": "usdxm",
        "tokenAddress": "z23BZbAiFRb6u5***64XjZPUud6dP6y2ZuKoYSM4LCY",
        "tokenDecimals": 6,
        "senderAddress": "YcnysYh3Y***PxkazFyiTx76Upv12iP4sNGeHA2H4z2",
        "recipientAddress": "8aQ3Y97fxiX26P***kc3keoQEz5MtWBCVk4pEx96Sqeb",
        "transactionHash": null,
        "explorerLink": null,
        "blockchain": "solana",
        "sourceWalletAddress": "YcnysYh3Y***PxkazFyiTx76Upv12iP4sNGeHA2H4z2",
        "recipientWalletAddress": "8aQ3Y97fxiX26P***kc3keoQEz5MtWBCVk4pEx96Sqeb",
        "sourceWalletId": null,
        "recipientWalletId": null,
        "createdAt": "2026-01-08T00:38:24+01:00",
        "updatedAt": "2026-01-08T00:38:39+01:00"
      }
    ],
    "pagination": {
      "currentPage": 1,
      "totalPages": 1,
      "totalItems": 2,
      "itemsPerPage": 10,
      "hasNextPage": false,
      "hasPrevPage": false
    }
  }
}

Path Parameters

string

required

Crypto wallet ID (crypto address entity ID)

Headers

string

required

API Key for authentication

Query Parameters

number

default:"1"

Page number for pagination

number

default:"10"

Number of items per page

string

Filter by transaction type: DEPOSIT, WITHDRAWAL, TRANSFER

string

Start date filter (ISO string)

string

End date filter (ISO string)

Request Example

curl -X GET "https://api-production.fossapay.com/api/v1/wallets/crypto/user:u3d/transactions?page=1&limit=10&transactionType=DEPOSIT" \
  -H "x-api-key: your_api_key_here"

const url = new URL(
  'https://api-production.fossapay.com/api/v1/wallets/crypto/user:u3d/transactions'
);

url.searchParams.set('page', '1');
url.searchParams.set('limit', '10');
url.searchParams.set('transactionType', 'DEPOSIT');
url.searchParams.set('startDate', '2024-01-01T00:00:00Z');
url.searchParams.set('endDate', '2024-12-31T23:59:59Z');

const response = await fetch(url.toString(), {
  method: 'GET',
  headers: {
    'x-api-key': 'your_api_key_here',
    'Content-Type': 'application/json',
  },
});

if (!response.ok) {
  throw new Error(`Request failed: ${response.status} ${response.statusText}`);
}

const data = await response.json();
const transactions = data.data.transactions;
console.log(transactions);

Response

{
  "status": "success",
  "statusCode": 200,
  "message": "Wallet transactions retrieved successfully",
  "data": {
    "transactions": [
      {
        "id": "9495d974-4807-4c44-bd01-f5a69283aecc",
        "reference": "PTY_CRYPTO_16TY0WY7MM717C9",
        "externalReference": "76c230a2-dcbd-4b40-a671-7db8d055d1c6",
        "transactionType": "deposit",
        "status": "failed",
        "amountInCrypto": "10.00000000",
        "tokenSymbol": "usdxm",
        "tokenAddress": "z23BZbAiFRb6u5***64XjZPUud6dP6y2ZuKoYSM4LCY",
        "tokenDecimals": 6,
        "senderAddress": "YcnysYh3Y***PxkazFyiTx76Upv12iP4sNGeHA2H4z2",
        "recipientAddress": "8aQ3Y97fxiX26P***kc3keoQEz5MtWBCVk4pEx96Sqeb",
        "transactionHash": null,
        "explorerLink": null,
        "blockchain": "solana",
        "sourceWalletAddress": "YcnysYh3Y***PxkazFyiTx76Upv12iP4sNGeHA2H4z2",
        "recipientWalletAddress": "8aQ3Y97fxiX26P***kc3keoQEz5MtWBCVk4pEx96Sqeb",
        "sourceWalletId": null,
        "recipientWalletId": null,
        "createdAt": "2026-01-08T00:43:44+01:00",
        "updatedAt": "2026-01-08T00:43:56+01:00"
      },
      {
        "id": "85503565-cb04-4ba7-abfb-b75193553086",
        "reference": "PTY_CRYPTO_NWC3GZ6832M9VFQ",
        "externalReference": "58fdb6f8-9925-4982-a516-95aabf4a22d3",
        "transactionType": "deposit",
        "status": "failed",
        "amountInCrypto": "10.00000000",
        "tokenSymbol": "usdxm",
        "tokenAddress": "z23BZbAiFRb6u5***64XjZPUud6dP6y2ZuKoYSM4LCY",
        "tokenDecimals": 6,
        "senderAddress": "YcnysYh3Y***PxkazFyiTx76Upv12iP4sNGeHA2H4z2",
        "recipientAddress": "8aQ3Y97fxiX26P***kc3keoQEz5MtWBCVk4pEx96Sqeb",
        "transactionHash": null,
        "explorerLink": null,
        "blockchain": "solana",
        "sourceWalletAddress": "YcnysYh3Y***PxkazFyiTx76Upv12iP4sNGeHA2H4z2",
        "recipientWalletAddress": "8aQ3Y97fxiX26P***kc3keoQEz5MtWBCVk4pEx96Sqeb",
        "sourceWalletId": null,
        "recipientWalletId": null,
        "createdAt": "2026-01-08T00:38:24+01:00",
        "updatedAt": "2026-01-08T00:38:39+01:00"
      }
    ],
    "pagination": {
      "currentPage": 1,
      "totalPages": 1,
      "totalItems": 2,
      "itemsPerPage": 10,
      "hasNextPage": false,
      "hasPrevPage": false
    }
  }
}

Customers

Virtual Wallets

NGN Transfers

Crypto Wallets

Crypto Transfers

Webhooks

Get All Wallet Transactions

Path Parameters

Headers

Query Parameters

Request Example

Response

Error Responses

​Path Parameters

​Headers

​Query Parameters

​Request Example

​Response

​Error Responses

Path Parameters

Headers

Query Parameters

Request Example

Response

Error Responses