Accounts concept

Accounts on Txn are currency accounts, representing the balances held in your business account on the Txn platform.

All tradable currencies supported by Txn are available in your business account by default.

Each account includes its total balance, running balance, currency code, ID, and a history of transactions. You can access this data either through the user interface by signing in to your business account or via API. Txn updates your account data in real-time.

Account hierarchy

Accounts are organized in a two-level hierarchy:

• Master accounts are created automatically for each tradable currency when your company is onboarded. These are your primary accounts, identified by "master": true and "label": "master".

• Subaccounts can be created under any master account to segment funds for different purposes - for example, separating balances by client, project, or business unit. Subaccounts are identified by "master": false and include a user-specified label assigned at creation.

The hierarchy follows the structure: Company → Master account (per currency) → Subaccounts.

For each of your digital asset subaccounts (e.g., BTC or USDT), you can create a new set of receiving addresses linked to that specific subaccount.

Bank references

Each EUR account has its own unique bankReference value (e.g., BDR7130670178476243). For EUR accounts, this reference is used for incoming bank deposits and ensures funds are credited to the correct account.

Reconciliation

Accessing your accounts, balances, and transaction history data through the txn API can be beneficial for reconciliation and maintaining data consistency. This can be particularly useful if you wish to fetch data from Txn and generate reports independently on your side.

Example API response

The following example shows the EUR and USDT master accounts with their subaccounts:

{
  "data": [
    {
      "id": "13a85b45-8543-41c7-b963-394d4ea128ae",
      "type": "accounts",
      "attributes": {
        "master": true,
        "currencyCode": "EUR",
        "label": "master",
        "bankReference": "BDR6421088115176062",
        "balance": "38475.76",
        "totalBalance": "38687.80",
        "currencyType": "fiat"
      }
    },
    {
      "id": "dd5016e1-43bb-4be5-b6d6-79e8d0f662b1",
      "type": "accounts",
      "attributes": {
        "master": false,
        "currencyCode": "EUR",
        "label": "EUR_1",
        "bankReference": "BDR4778763138567183",
        "balance": "80.54",
        "totalBalance": "80.54",
        "currencyType": "fiat"
      }
    },
    {
      "id": "ad5e0084-91d3-46c8-9f79-9231a75442e5",
      "type": "accounts",
      "attributes": {
        "master": false,
        "currencyCode": "EUR",
        "label": "EUR_2",
        "bankReference": "BDR8258604421708687",
        "balance": "52.89",
        "totalBalance": "52.89",
        "currencyType": "fiat"
      }
    },
    {
      "id": "0c201594-19fe-461b-bf37-0d14e51c3f3a",
      "type": "accounts",
      "attributes": {
        "master": false,
        "currencyCode": "EUR",
        "label": "EUR_3",
        "bankReference": "BDR7130670178476243",
        "balance": "78.61",
        "totalBalance": "78.61",
        "currencyType": "fiat"
      }
    },
    {
      "id": "e289de2b-37bd-4eff-b832-f754c31a2d95",
      "type": "accounts",
      "attributes": {
        "master": true,
        "currencyCode": "USDT",
        "label": "master",
        "bankReference": "BDR4180381621673581",
        "balance": "344086.455299",
        "totalBalance": "344219.499753",
        "currencyType": "crypto"
      }
    },
    {
      "id": "fbae9123-59bb-49db-bc6b-0f766c189494",
      "type": "accounts",
      "attributes": {
        "master": false,
        "currencyCode": "USDT",
        "label": "USDT_1",
        "bankReference": "BDR4654328482173537",
        "balance": "78.915973",
        "totalBalance": "78.915973",
        "currencyType": "crypto"
      }
    },
    {
      "id": "2df68c92-b9dd-4ff4-b7f2-5aeb381bf6fc",
      "type": "accounts",
      "attributes": {
        "master": false,
        "currencyCode": "USDT",
        "label": "USDT_2",
        "bankReference": "BDR0042354445442825",
        "balance": "31.434196",
        "totalBalance": "31.434196",
        "currencyType": "crypto"
      }
    },
    {
      "id": "c20dec56-10ce-49e0-ad00-916579f0c04a",
      "type": "accounts",
      "attributes": {
        "master": false,
        "currencyCode": "USDT",
        "label": "USDT_3",
        "bankReference": "BDR3865252360837137",
        "balance": "10.301300",
        "totalBalance": "10.301300",
        "currencyType": "crypto"
      }
    },
    {
      "id": "468a0e31-d9e5-4ad8-86aa-6c4806d40a2d",
      "type": "accounts",
      "attributes": {
        "master": false,
        "currencyCode": "USDT",
        "label": "USDT_4",
        "bankReference": "BDR8606155657480464",
        "balance": "12.392985",
        "totalBalance": "12.392985",
        "currencyType": "crypto"
      }
    }
  ]
  "meta": {
    "page": 1,
    "per_page": 50,
    "total": 34
  },
  "jsonapi": {
    "version": "1.0"
  }
}