Transaction History

Get comprehensive transaction history across all wallets, including payments and withdrawals.

List Transaction History

GET

/transactions/transactions/

Get a unified view of all transactions across your account.

Authentication

Requires OAuth 2.0 authentication with read scope.

Query Parameters

Parameter	Type	Required	Description
`page`	integer	No	Page number (default: 1)
`page_size`	integer	No	Results per page (default: 20, max: 100)
`type`	string	No	Transaction type: "payment" or "withdrawal"
`status`	string	No	Filter by transaction status
`currency`	string	No	Filter by currency (e.g., "USDTERC20")
`date_from`	datetime	No	Start date (ISO 8601 format)
`date_to`	datetime	No	End date (ISO 8601 format)

Example Request

curl -X GET "https://api.cryptofuse.io/transactions/transactions/?page=1&page_size=20&type=payment" \
  -H "Authorization: Bearer your_access_token"

Response

Success Response (200 OK)

{
  "count": 150,
  "next": "https://api.cryptofuse.io/transactions/transactions/?page=2&page_size=20",
  "previous": null,
  "results": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "type": "payment",
      "transaction_id": "550e8400-e29b-41d4-a716-446655440000",
      "amount": "100.00",
      "currency": "USDTERC20",
      "status": "completed",
      "created_at": "2025-01-15T10:00:00Z",
      "updated_at": "2025-01-15T10:05:00Z",
      "reference": "ORDER-12345",
      "blockchain_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f8b8E0",
      "transaction_hash": "0x123abc...",
      "fee_amount": "1.00",
      "net_amount": "99.00",
      "metadata": {
        "order_id": "ORDER-12345",
        "confirmations": 12
      }
    },
    {
      "id": "660e8400-e29b-41d4-a716-446655440001",
      "type": "withdrawal",
      "withdrawal_id": "660e8400-e29b-41d4-a716-446655440001",
      "amount": "50.00",
      "currency": "USDCERC20",
      "status": "completed",
      "created_at": "2025-01-14T15:30:00Z",
      "updated_at": "2025-01-14T15:35:00Z",
      "reference": "WITHDRAW-001",
      "blockchain_address": "0x123456789abcdef...",
      "transaction_hash": "0x456def...",
      "fee_amount": "2.50",
      "net_amount": "47.50",
      "metadata": {
        "custom_id": "WITHDRAW-001",
        "network_fee": "2.50"
      }
    }
  ]
}

Response Fields

Field	Type	Description
`id`	string	Transaction UUID
`type`	string	Transaction type: "payment" or "withdrawal"
`amount`	string	Transaction amount
`currency`	string	Currency code
`status`	string	Transaction status
`created_at`	datetime	Creation timestamp
`updated_at`	datetime	Last update timestamp
`reference`	string	Your reference ID
`blockchain_address`	string	Blockchain address
`transaction_hash`	string	Blockchain transaction hash
`fee_amount`	string	Transaction fee
`net_amount`	string	Net amount after fees
`metadata`	object	Additional transaction metadata

Transaction Statuses

Status	Description
`waiting`	Waiting for payment
`confirming`	Confirming blockchain transaction
`confirmed`	Transaction confirmed
`sending`	Sending to recipient
`completed`	Transaction completed successfully
`failed`	Transaction failed
`expired`	Transaction expired

Error Responses

Authentication Error (401)

{
  "error": {
    "code": "authentication_failed",
    "message": "Invalid or expired access token"
  }
}

Rate Limit Exceeded (429)

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests. Please try again later.",
    "details": {
      "retry_after": 60
    }
  }
}

Filter by Transaction Type

You can filter transactions by type using the type parameter:

payment - Show only incoming payments
withdrawal - Show only outgoing withdrawals

Example:

# Get only payments
curl -X GET "https://api.cryptofuse.io/transactions/transactions/?type=payment" \
  -H "Authorization: Bearer your_access_token"

# Get only withdrawals
curl -X GET "https://api.cryptofuse.io/transactions/transactions/?type=withdrawal" \
  -H "Authorization: Bearer your_access_token"

Date Range Filtering

Use date_from and date_to parameters to filter transactions by date:

curl -X GET "https://api.cryptofuse.io/transactions/transactions/?date_from=2025-01-01T00:00:00Z&date_to=2025-01-31T23:59:59Z" \
  -H "Authorization: Bearer your_access_token"

Pagination

The API returns paginated results. Use the page and page_size parameters to navigate through results:

Default page size: 20
Maximum page size: 100

The response includes:

count: Total number of transactions
next: URL for the next page (if available)
previous: URL for the previous page (if available)

Rate Limiting

This endpoint is rate-limited to:

100 requests per minute per API key
1000 requests per hour per API key

Exceeded limits will return a 429 status code with retry information.

List Transaction History​