Skip to main content
GET
/
v3
/
status
/
get-tx-history
Get transaction history
curl --request GET \
  --url https://be.onebalance.io/api/v3/status/get-tx-history \
  --header 'x-api-key: <api-key>'
{ "transactions": [ { "quoteId": "0xfa6094cd9d65416c975e3498cc5c2ca17df6c4cfa37e16f84f2736296dd98b5d", "status": "COMPLETED", "user": "0x9b747cC14A5672a7166b4eccdc92d7F4003f8081", "recipientAccountId": "eip155:1/0x9b747cC14A5672a7166b4eccdc92d7F4003f8081", "originChainOperations": [ { "hash": "0xfa6094cd9d65416c975e3498cc5c2ca17df6c4cfa37e16f84f2736296dd98b5d", "chain": "eip155:1", "explorerUrl": "https://etherscan.io/tx/0xfa6094cd9d65416c975e3498cc5c2ca17df6c4cfa37e16f84f2736296dd98b5d" } ], "destinationChainOperations": [ { "hash": "0xfa6094cd9d65416c975e3498cc5c2ca17df6c4cfa37e16f84f2736296dd98b5d", "chain": "eip155:1", "explorerUrl": "https://etherscan.io/tx/0xfa6094cd9d65416c975e3498cc5c2ca17df6c4cfa37e16f84f2736296dd98b5d" } ], "type": "SWAP", "originToken": { "aggregatedAssetId": "ob:eth", "amount": "1000000000000000000", "assetType": [ "eip155:1/erc20:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "eip155:1/slip44:60" ], "fiatValue": [ { "assetType": "eip155:1/erc20:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "fiatValue": "1800" } ] }, "destinationToken": { "aggregatedAssetId": "ob:usdc", "amount": "1800000000", "assetType": "eip155:1/erc20:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "fiatValue": "1800" }, "timestamp": "2024-01-01T12:00:00.000Z" } ], "continuation": "txn_v3_evm_456789abcdef" }

Documentation Index

Fetch the complete documentation index at: https://docs.onebalance.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

The OneBalance API uses API keys to authenticate requests. All API requests require authentication using an API key passed in the x-api-key header:

curl -X 'GET' \
  'https://be.onebalance.io/api/path-to/endpoint' \
  -H 'x-api-key: ${ONEBALANCE_API_KEY}' \
  ...

A public API key is available for testing purposes with limited usage: 42bb629272001ee1163ca0dbbbc07bcbb0ef57a57baf16c4b1d4672db4562c11.

All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail.

Learn how to generate API access tokens at OneBalance Docs.

Query Parameters

​
user
string
required

The address for which to retrieve the transaction history (supports both EVM and Solana addresses)

Example:

"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

​
limit
integer
default:20

Maximum number of transactions to return

Required range: x >= 1
Example:

10

​
continuation
string

The continuation string for retrieving the next page of transactions

Example:

"txn_v3_00123456789abcdef"

​
sortBy
enum<string>
default:createdAt

Field to sort the transaction history by. Defaults to createdAt if not specified.

Available options:
createdAt,
updatedAt
Example:

"createdAt"

Response

Successfully retrieved the transaction history

Transaction history response for v3 endpoints with CAIP identifiers

​
transactions
object[]
required

List of transactions for the user

​
continuation
string

String to provide in order to fetch the next page of results

Example:

"txn_00123456789abcdef"

Last modified on August 11, 2025