Transfer History

POST

/wallets/transfer-history/

Retrieves the transfer history for a specific wallet. Supports filtering by status, transfer type, and currency, with pagination support.

Request Parameters

Parameter	Type	Required	Description
wallet_id	string	Yes	The system-assigned wallet identifier
status	string	No	Filter by transfer status (e.g., "completed", "pending", "failed")
transfer_type	string	No	Filter by transfer type (e.g., "to_sub", "to_master")
currency	string	No	Filter by currency code (e.g., "USDTTRC20", "BTC")
limit	integer	No	Maximum number of results to return
offset	integer	No	Number of results to skip (for pagination)

Authentication

This endpoint requires authentication using one of the following methods:

Authentication Type	Header	Description
OAuth 2.0	Authorization	Bearer your_access_token
API Key	X-API-Key	your_api_key

Example Request

curl -X POST "https://api.cryptofuse.io/api/v1/wallets/transfer-history/" \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_id": "w_abc123def456",
    "status": "completed",
    "currency": "USDTTRC20",
    "limit": 10,
    "offset": 0
  }'

Response

Field	Type	Description
account	object	Wallet account details
transfers	array	Array of transfer objects
pagination	object	Pagination metadata

Example Response

{
  "account": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Player 12345",
    "external_id": "player-12345",
    "wallet_id": "w_abc123def456"
  },
  "transfers": [
    {
      "id": "6d3f0960-5551-4af5-9601-aeecc512a87a",
      "transfer_type": "to_sub",
      "currency": "USDTTRC20",
      "amount": "100.00",
      "status": "completed",
      "created_at": "2025-04-20T10:30:00.000Z"
    },
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "transfer_type": "to_master",
      "currency": "USDTTRC20",
      "amount": "50.00",
      "status": "completed",
      "created_at": "2025-04-19T14:15:00.000Z"
    }
  ],
  "pagination": {
    "total": 25,
    "limit": 10,
    "offset": 0
  }
}

Error Codes

Status Code	Error Code	Description
400	invalid_request	Missing wallet_id or invalid filter values
401	unauthorized	Authentication failed
403	forbidden	User doesn't have required permissions
404	not_found	Wallet not found
500	server_error	Internal server error

Error Response Format

{
  "error": {
    "code": "not_found",
    "message": "Wallet not found",
    "details": {}
  }
}

Notes

• Use the transfer_id returned by Transfer to User or Withdraw to Master to look up specific transfers in the history.
• Filters are optional and can be combined. Omitting all filters returns all transfers for the wallet.
• Results are ordered by creation date (most recent first).
• Required scopes: read, write.