GET
/
status
/
get-tx-history
curl --request GET \
  --url https://be.onebalance.io/api/status/get-tx-history \
  --header 'x-api-key: <api-key>'
{
  "transactions": [
    {
      "quoteId": "0xfa6094cd9d65416c975e3498cc5c2ca17df6c4cfa37e16f84f2736296dd98b5d",
      "status": {
        "status": "COMPLETED"
      },
      "user": "0x9b747cC14A5672a7166b4eccdc92d7F4003f8081",
      "recipientAccountId": "eip155:1/0x9b747cC14A5672a7166b4eccdc92d7F4003f8081",
      "originChainOperations": [
        {
          "hash": "0xfa6094cd9d65416c975e3498cc5c2ca17df6c4cfa37e16f84f2736296dd98b5d",
          "chainId": 1,
          "explorerUrl": "https://etherscan.io/tx/0xfa6094cd9d65416c975e3498cc5c2ca17df6c4cfa37e16f84f2736296dd98b5d"
        }
      ],
      "destinationChainOperations": [
        {
          "hash": "0xfa6094cd9d65416c975e3498cc5c2ca17df6c4cfa37e16f84f2736296dd98b5d",
          "chainId": 1,
          "explorerUrl": "https://etherscan.io/tx/0xfa6094cd9d65416c975e3498cc5c2ca17df6c4cfa37e16f84f2736296dd98b5d"
        }
      ],
      "type": "SWAP",
      "originToken": {
        "aggregatedAssetId": "ds:eth",
        "amount": "1000000000000000000",
        "assetType": [
          "eip155:1/erc20:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
          "eip155:1/slip44:60"
        ],
        "fiatValue": [
          {
            "assetType": "eip155:1/erc20:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
            "fiatValue": "1800"
          }
        ]
      },
      "destinationToken": {
        "aggregatedAssetId": "ds:usdc",
        "amount": "1800000000",
        "assetType": "eip155:1/erc20:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "fiatValue": "1800"
      },
      "timestamp": "2024-01-01T12:00:00.000Z"
    },
    {
      "quoteId": "0xed8c3dd2455c0569c63aef2ac8fa63d94a9b35caed36e3a70ee3af01cec3a7d5",
      "status": {
        "status": "COMPLETED"
      },
      "user": "0x9b747cC14A5672a7166b4eccdc92d7F4003f8081",
      "recipientAccountId": "eip155:10/0x7654321aBC987654321DEF12345678901234567",
      "originChainOperations": [
        {
          "hash": "0xed8c3dd2455c0569c63aef2ac8fa63d94a9b35caed36e3a70ee3af01cec3a7d5",
          "chainId": 1,
          "explorerUrl": "https://etherscan.io/tx/0xed8c3dd2455c0569c63aef2ac8fa63d94a9b35caed36e3a70ee3af01cec3a7d5"
        }
      ],
      "destinationChainOperations": [
        {
          "hash": "0xa1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
          "chainId": 10,
          "explorerUrl": "https://optimistic.etherscan.io/tx/0xa1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2"
        }
      ],
      "type": "TRANSFER",
      "originToken": {
        "aggregatedAssetId": "ds:usdc",
        "amount": "500000000",
        "assetType": [
          "eip155:1/erc20:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
        ],
        "fiatValue": [
          {
            "assetType": "eip155:1/erc20:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
            "fiatValue": "500"
          }
        ]
      },
      "destinationToken": {
        "aggregatedAssetId": "ds:usdc",
        "amount": "495000000",
        "assetType": "eip155:10/erc20:0x7f5c764cbc14f9669b88837ca1490cca17c31607",
        "fiatValue": "495"
      },
      "timestamp": "2023-12-31T18:30:00.000Z"
    }
  ],
  "continuation": "txn_00123456789abcdef"
}

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

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_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

200
application/json

Successfully retrieved the transaction history

The response is of type object.