Skip to main content
Version: 2025-11-12.1

Transactions

Data Model​

Account Interest Transaction​

  • accountAmount (number, required): Amount deposited or withdrawn from the account. Denominated in account currency.
  • comment (string, optional): A brief text note or explanation related to the transaction.
  • tradeDate (string, required): ISO 8601 representation of the transaction's trade date (end-of-day).
  • valueDate (string, required): ISO 8601 representation of the transaction's value date (end-of-day).

Relationships​

  • account: Account represents the bank account affected by the transaction.

Bond Coupon Transaction​

  • accountAmount (number, required): Amount deposited or withdrawn from the account. Denominated in account currency.
  • comment (string, optional): A brief text note or explanation related to the transaction.
  • grossAmount (number, required): Total coupon amount. Denominated in asset currency.
  • tradeDate (string, required): ISO 8601 representation of the transaction's trade date (end-of-day).
  • valueDate (string, required): ISO 8601 representation of the transaction's value date (end-of-day).

Relationships​

  • account: Account represents the bank account affected by the transaction.
  • asset: Asset represents the asset affected by the transaction.
  • depository: Depository represents the depository the asset is held in.

Bond Redemption Transaction​

  • accountAmount (number, required): Amount deposited or withdrawn from the account. Denominated in account currency.
  • comment (string, optional): A brief text note or explanation related to the transaction.
  • tradeDate (string, required): ISO 8601 representation of the transaction's trade date (end-of-day).
  • unitPrice (number, required): Price per asset unit.
  • units (number, required): Number of units redeemed.
  • valueDate (string, required): ISO 8601 representation of the transaction's value date (end-of-day).

Relationships​

  • account: Account represents the bank account affected by the transaction.
  • asset: Asset represents the asset affected by the transaction.
  • depository: Depository represents the depository affected by the transaction.

Bond Trade Transaction​

  • accountAmount (number, required): Amount deposited or withdrawn from the account. Denominated in account currency.
  • accruedInterest (number, required): Interest accumulated on the bond from the latest repayment date to the transaction date. Denominated in asset currency.
  • commission (number, required): Commission charged by the bank or custodian. Denominated in account currency. A positive number means commission paid.
  • comment (string, optional): A brief text note or explanation related to the transaction.
  • tradeDate (string, required): ISO 8601 representation of the transaction's trade date (end-of-day).
  • unitPrice (number, required): Price per asset unit.
  • units (number, required): Number of units bought or sold.
  • valueDate (string, required): ISO 8601 representation of the transaction's value date (end-of-day).

Relationships​

  • account: Account represents the bank account affected by the transaction.
  • asset: Asset represents the asset affected by the transaction.
  • depository: Depository represents the depository affected by the transaction.

Cash Transfer Transaction​

The cash transfer transaction type can be used for both external cash transfers to an outside account and internal cash transfers between accounts. This is done by assigning the counterparty-transaction relationships object with the ID of the related counterparty transaction. See example.

  • accountAmount (number, required): Amount deposited or withdrawn from the account. Denominated in account currency.
  • comment (string, optional): A brief text note or explanation related to the transaction.
  • tradeDate (string, required): ISO 8601 representation of the transaction's trade date (end-of-day).
  • valueDate (string, required): ISO 8601 representation of the transaction's value date (end-of-day).

Relationships​

  • account: Account represents the bank account affected by the transaction.
  • counterparty-transaction: Counterparty transaction is the linked transaction associated with the transaction being displayed.

Dividend Transaction​

  • accountAmount (number, required): Amount deposited or withdrawn from the account. Denominated in account currency.
  • comment (string, optional): A brief text note or explanation related to the transaction.
  • commission (number, optional): Commission charged by the bank or custodian. Denominated in account currency. A positive number means commission paid. Defaults to zero if not specified.
  • grossAmount (number, required): Total dividend amount before any deductions. Denominated in asset currency.
  • tax (number, required): Tax charged as part of the transaction. Denominated in asset currency.
  • tradeDate (string, required): ISO 8601 representation of the transaction's trade date (end-of-day).
  • valueDate (string, required): ISO 8601 representation of the transaction's value date (end-of-day).

Relationships​

  • account: Account represents the bank account affected by the transaction.
  • asset: Asset represents the asset affected by the transaction.
  • depository: Depository represents the depository the asset is held in.

Equity Trade Transaction​

  • accountAmount (number, required): Amount deposited or withdrawn from the account. Denominated in account currency.
  • commission (number, required): Commission charged by the bank or custodian. Denominated in account currency. A positive number means commission paid.
  • comment (string, optional): A brief text note or explanation related to the transaction.
  • tradeDate (string, required): ISO 8601 representation of the transaction's trade date (end-of-day).
  • unitPrice (number, required): Price per asset unit.
  • units (number, required): Number of units bought or sold.
  • valueDate (string, required): ISO 8601 representation of the transaction's value date (end-of-day).

Relationships​

  • account: Account represents the bank account affected by the transaction.
  • asset: Asset represents the asset affected by the transaction.
  • depository: Depository represents the depository affected by the transaction.

Fee Transaction​

  • accountAmount (number, required): Amount deposited or withdrawn from the account. Denominated in account currency.
  • comment (string, optional): A brief text note or explanation related to the transaction.
  • category (string, required): Type of fee. Possible values: "custody", "management", "other". Default is "other".
  • tradeDate (string, required): ISO 8601 representation of the transaction's trade date (end-of-day).
  • valueDate (string, required): ISO 8601 representation of the transaction's value date (end-of-day).
info

Any fee transaction created will have an effect on the balance of the account involved, but the return will be reflected on the corresponding fee asset.

Relationships​

  • account: Account represents the bank account affected by the transaction.

Futures Trade Transaction​

  • accountAmount (number, required): Amount deposited or withdrawn from the account. Denominated in account currency.
  • commission (number, required): Commission charged by the bank or custodian. Denominated in account currency. A positive number means commission paid.
  • comment (string, optional): A brief text note or explanation related to the transaction.
  • tradeDate (string, required): ISO 8601 representation of the transaction's trade date (end-of-day).
  • unitPrice (number, required): Price per asset unit.
  • units (number, required): Number of units bought or sold.
  • valueDate (string, required): ISO 8601 representation of the transaction's value date (end-of-day).

Relationships​

  • account: Account represents the bank account affected by the transaction.
  • asset: Asset represents the asset affected by the transaction.
  • depository: Depository represents the depository affected by the transaction.

Futures Execution Transaction​

  • accountAmount (number, required): Amount deposited or withdrawn from the account. Denominated in account currency.
  • commission (number, required): Commission charged by the bank or custodian. Denominated in account currency. A positive number means commission paid.
  • comment (string, optional): A brief text note or explanation related to the transaction.
  • tradeDate (string, required): ISO 8601 representation of the transaction's trade date (end-of-day).
  • unitPrice (number, required): Price per asset unit.
  • units (number, required): Number of units bought or sold.
  • valueDate (string, required): ISO 8601 representation of the transaction's value date (end-of-day).

Relationships​

  • account: Account represents the bank account affected by the transaction.
  • asset: Asset represents the asset affected by the transaction.
  • openingTransaction: Opening transaction is the futures trade transaction associated with the transaction being displayed.
  • depository: Depository represents the depository affected by the transaction.

FX Forward Cash Settlement Transaction​

  • accountAmount (number, required): Amount deposited or withdrawn from the account. Denominated in account currency.
  • tradeDate (string, required): ISO 8601 representation of the transaction's trade date (end-of-day).
  • valueDate (string, required): ISO 8601 representation of the transaction's value date (end-of-day).
info

FX Forward Cash Settlement Transactions cannot be created directly through POST /api/v2/transactions. They are created automatically as a result of the settlement of an FX Forward, Cash Settlement.

Relationships​

  • account: Account represents the bank account affected by the transaction.
  • fxForward: The FX Forward agreement that is being settled.

FX Forward Physical Delivery Transaction​

  • primaryAccountAmount (number, required): Amount deposited or withdrawn from the related account primaryAccount. Denominated in the currency of the primary account.
  • secondaryAccountAmount (number, required): Amount deposited or withdrawn from the related account secondaryAccount. Denominated in the currency of the secondary account.
  • tradeDate (string, required): ISO 8601 representation of the transaction's trade date.
  • valueDate (string, required): ISO 8601 representation of the transaction's value date.
info

FX Forward Physical Delivery Transactions cannot be created directly through POST /api/v2/transactions. They are created automatically as a result of the settlement of an FX Forward, Physical Delivery.

Relationships​

  • primaryAccount: Represents the bank account affected by the primary currency of the FX pair.
  • secondaryAccount: Represents the bank account affected by the secondary currency of the FX pair.
  • fxForward: The FX Forward agreement that is being settled.

FX Spot Transaction​

  • comment (string, optional): A brief text note or explanation related to the transaction.
  • inflowAccountAmount (number, required): Amount deposited to the related account inflowAccount. The amount must be positive and is denominated in the currency of the inflow account.
  • outflowAccountAmount (number, required): Amount withdrawn from the related account outflowAccount. The amount must be negative and is denominated in the currency of the outflow account.
  • tradeDate (string, required): ISO 8601 representation of the transaction's trade date.
  • valueDate (string, required): ISO 8601 representation of the transaction's value date.

Relationships​

  • inflowAccount: Account to which the inflow currency of the FX pair is deposited.
  • outflowAccount: Account from which the outflow currency of the FX pair is withdrawn.

Index-Linked Bond Coupon Transaction​

  • accountAmount (number, required): Amount deposited or withdrawn from the account. Denominated in account currency.
  • comment (string, optional): A brief text note or explanation related to the transaction.
  • grossAmount (number, required): Total coupon amount. Denominated in asset currency.
  • indexFactor (number, required): The index factor to use for the transaction.
  • tradeDate (string, required): ISO 8601 representation of the transaction's trade date (end-of-day).
  • valueDate (string, required): ISO 8601 representation of the transaction's value date (end-of-day).

Relationships​

  • account: Account represents the bank account affected by the transaction.
  • asset: Asset represents the asset affected by the transaction.
  • depository: Depository represents the depository the asset is held in.

Index-Linked Bond Redemption Transaction​

  • accountAmount (number, required): Amount deposited or withdrawn from the account. Denominated in account currency.
  • comment (string, optional): A brief text note or explanation related to the transaction.
  • indexFactor (number, required): The index factor to use for the transaction.
  • tradeDate (string, required): ISO 8601 representation of the transaction's trade date (end-of-day).
  • unitPrice (number, required): Price per asset unit.
  • units (number, required): Number of units redeemed.
  • valueDate (string, required): ISO 8601 representation of the transaction's value date (end-of-day).

Relationships​

  • account: Account represents the bank account affected by the transaction.
  • asset: Asset represents the asset affected by the transaction.
  • depository: Depository represents the depository affected by the transaction.

Index-Linked Bond Trade Transaction​

  • accountAmount (number, required): Amount deposited or withdrawn from the account. Denominated in account currency.
  • accruedInterest (number, required): Interest accumulated on the bond from the latest repayment date to the transaction date. Denominated in asset currency.
  • commission (number, required): Commission charged by the bank or custodian. Denominated in account currency. A positive number means commission paid.
  • comment (string, optional): A brief text note or explanation related to the transaction.
  • indexFactor (string, optional): The index factor to use for the transaction.
  • tradeDate (string, required): ISO 8601 representation of the transaction's trade date (end-of-day).
  • unitPrice (number, required): Price per asset unit.
  • units (number, required): Number of units bought or sold.
  • valueDate (string, required): ISO 8601 representation of the transaction's value date (end-of-day).

Relationships​

  • account: Account represents the bank account affected by the transaction.
  • asset: Asset represents the asset affected by the transaction.
  • depository: Depository represents the depository affected by the transaction.

Loan Transaction​

  • accountAmount (number, required): Amount deposited or withdrawn from the account. Denominated in account currency.
  • interest (number, optional): Interest amount related to the loan. Denominated in account currency.
  • tradeDate (string, required): ISO 8601 representation of the transaction's trade date.
  • valueDate (string, required): ISO 8601 representation of the transaction's value date.
info

Loan Transactions cannot be created directly through POST /api/v2/transactions. They are created automatically as a result of creating a Loan. One Loan Transaction is created for the agreementDate and one Loan Transaction is created for the maturityDate.

Relationships​

  • account: Account represents the bank account affected by the transaction.
  • loan: The loan asset that the transaction belongs to.

Private Market Fund Distribution Transaction​

  • category (string, required): Type of distribution transaction. Possible values:
    • "distribution"
    • "capital-gain"
    • "dividend"
    • "return-of-capital"
    • "interest-received"
    • "carried-interest"
    • "withholding-tax"
  • amount (number, required): The distributed amount from the fund. Denominated in the fund's currency. The distributed amount should be a postive value (negative values are allowed for corrections).
  • recallableAmount (number, required): The part of the amount that is recallable. Use 0 for a non-recallable distribution. Use the amount value for a fully recallable distribution. Or use a number between 0 and amount for a partially recallable distribution.
  • affectsEstimatedNav (bool, required): Whether this transaction should impact the instrument’s estimated NAV at the transaction date. Set to true to include or false to exclude.
  • affectsMultiples (bool, required): Whether this cash flow is included in private‑markets multiples calculations (e.g., TVPI, DPI, RVPI). Set to true to include or false to exclude. Recommended value is true for most transactions.
  • affectsIrr (bool, required): Whether this cash flow is included in IRR calculations. Set to true to include or false to exclude. Recommended value is true for most transactions.
  • affectsCostBase (bool, required): Whether this transaction adjusts the investor’s cost basis. Set to true to adjust cost basis (e.g., capital calls or certain fees) or false if it should not affect cost basis. Recommended value is true for most transactions.
  • accountAmount (number, required): Amount deposited or withdrawn from the account. Denominated in account currency.
  • comment (string, optional): A brief text note or explanation related to the transaction.
  • tradeDate (string, required): ISO 8601 representation of the transaction's trade date (end-of-day).
  • valueDate (string, required): ISO 8601 representation of the transaction's value date (end-of-day).

Relationships​

  • account: Account represents the bank account affected by the transaction.
  • instrument: Instrument represents the fund affected by the transaction.

Private Market Fund Drawdown Transaction​

  • category (string, required): Type of drawdown transaction. Possible values:
    • "capital-call"
    • "management-fee"
    • "interest-paid"
    • "other-fee"
  • amount (number, required): The called amount from the fund. Denominated in the fund's currency. The drawdown amount should have postive sign (negative values are allowed for corrections).
  • effectOnUnfundedCommitment (number, required): Signed change to the remaining unfunded commitment caused by this drawdown. Use a negative value to reduce the unfunded commitment (typical for capital calls), a positive value to increase it (e.g., corrections), or "0" for no change.
  • affectsEstimatedNav (bool, required): Whether this transaction should impact the instrument’s estimated NAV at the transaction date. Set to true to include or false to exclude. Recommended value is true for most transactions.
  • affectsMultiples (bool, required): Whether this cash flow is included in private‑markets multiples calculations (e.g., TVPI, DPI, RVPI). Set to true to include or false to exclude. Recommended value is true for most transactions.
  • affectsIrr (bool, required): Whether this cash flow is included in IRR calculations. Set to true to include or false to exclude. Recommended value is true for most transactions.
  • affectsCostBase (bool, required): Whether this transaction adjusts the investor’s cost basis. Set to true to adjust cost basis (e.g., capital calls or certain fees) or false if it should not affect cost basis. Recommended value is true for most transactions.
  • accountAmount (number, required): Amount deposited or withdrawn from the account. Denominated in account currency.
  • comment (string, optional): A brief text note or explanation related to the transaction.
  • tradeDate (string, required): ISO 8601 representation of the transaction's trade date (end-of-day).
  • valueDate (string, required): ISO 8601 representation of the transaction's value date (end-of-day).

Relationships​

  • account: Account represents the bank account affected by the transaction.
  • instrument: Instrument represents the fund affected by the transaction.

Refund Transaction​

  • accountAmount (number, required): Amount deposited or withdrawn from the account. Denominated in account currency.
  • comment (string, optional): A brief text note or explanation related to the transaction.
  • tradeDate (string, required): ISO 8601 representation of the transaction's trade date (end-of-day).
  • valueDate (string, required): ISO 8601 representation of the transaction's value date (end-of-day).
info

Any refund transaction created will have an effect on the balance of the account involved, but the return will be reflected on the corresponding refund asset.

Relationships​

  • account: Account represents the bank account affected by the transaction.

Zero Coupon Bond Trade Transaction​

  • accountAmount (number, required): Amount deposited or withdrawn from the account. Denominated in account currency.
  • commission (number, required): Commission charged by the bank or custodian. Denominated in account currency. A positive number means commission paid.
  • comment (string, optional): A brief text note or explanation related to the transaction.
  • tradeDate (string, required): ISO 8601 representation of the transaction's trade date (end-of-day).
  • unitPrice (number, required): Price per asset unit.
  • units (number, required): Number of units bought or sold.
  • valueDate (string, required): ISO 8601 representation of the transaction's value date (end-of-day).

Relationships​

  • account: Account represents the bank account affected by the transaction.
  • asset: Asset represents the asset affected by the transaction.
  • depository: Depository represents the depository affected by the transaction.

Endpoints​

GET /transactions​

Fetch all transactions within a specified period for an accountId, a depositoryId, or both.

Parameters​

  • accountId (query, optional): Account identifier.
  • depositoryId (query, optional): Depository identifier.
  • fromDate (query, required): First day in the time period.
  • toDate (query, required): Last day in the time period.
info

fromDate and toDate make up a closed interval, meaning that transactions on both dates are included in the output.

Examples​

Account Interest Transaction​
200 OK 
# Request
GET /api/v2/transactions
  ?accountId=6698ffbdda04cf5d2d55a265
  &fromDate=2024-07-01
  &toDate=2024-07-01 HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Host: platform.aleta.io


# Response
HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
  "data": [
    {
      "id": "66990014c5dc848e8f97c1bb",
      "type": "account-interest-transaction",
      "attributes": {
        "accountAmount": 1594.87,
        "comment": "Account Interest Q2",
        "tradeDate": "2024-07-01",
        "valueDate": "2024-07-01"
      },
      "relationships": {
        "account": {
          "data": {
            "type": "account",
            "id": "6698ffbdda04cf5d2d55a265"
          }
        }
      }
    }
  ]
}
Bond Coupon Transaction​
200 OK 
# Request
GET /api/v2/transactions
  ?accountId=6698ffbdda04cf5d2d55a265
  &fromDate=2024-07-01
  &toDate=2024-07-01 HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Host: platform.aleta.io


# Response
HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
  "data": [
    {
      "id": "66990014c5dc848e8f97c1bb",
      "type": "bond-coupon-transaction",
      "attributes": {
        "accountAmount": 7500.00,
        "comment": "Bond Coupon",
        "grossAmount": 7500.00,
        "tradeDate": "2024-07-01",
        "valueDate": "2024-07-01"
      },
      "relationships": {
        "account": {
          "data": {
            "type": "account",
            "id": "6698ffbdda04cf5d2d55a265"
          }
        },
        "asset": {
          "data": {
            "type": "asset",
            "id": "b5afc699f5e3a15556d2a00c"
          }
        },
        "depository": {
          "data": {
            "type": "depository",
            "id": "6698ffae47a5a2c8b2554ee8"
          }
        }
      }
    }
  ]
}
Bond Redemption Transaction​
200 OK 
# Request
GET /api/v2/transactions
  ?accountId=6698ffbdda04cf5d2d55a265
  &fromDate=2024-07-01
  &toDate=2024-07-01 HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Host: platform.aleta.io


# Response
HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
  "data": [
    {
      "id": "66990014c5dc848e8f97c1bb",
      "type": "bond-redemption-transaction",
      "attributes": {
        "accountAmount": 50000.00,
        "comment": "Bond Redemption",
        "tradeDate": "2024-07-01",
        "unitPrice": 100.00,
        "units": -50000.00,
        "valueDate": "2024-07-01"
      },
      "relationships": {
        "account": {
          "data": {
            "type": "account",
            "id": "6698ffbdda04cf5d2d55a265"
          }
        },
        "asset": {
          "data": {
            "type": "asset",
            "id": "b5afc699f5e3a15556d2a00c"
          }
        },
        "depository": {
          "data": {
            "type": "depository",
            "id": "6698ffae47a5a2c8b2554ee8"
          }
        }
      }
    }
  ]
}
Bond Trade Transaction​
200 OK 
# Request
GET /api/v2/transactions
  ?accountId=6698ffbdda04cf5d2d55a265
  &fromDate=2024-07-01
  &toDate=2024-07-01 HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Host: platform.aleta.io


# Response
HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
  "data": [
    {
      "id": "66990014c5dc848e8f97c1bb",
      "type": "bond-trade-transaction",
      "attributes": {
        "accountAmount": -349234.22,
        "accruedInterest": -910.83,
        "comment": "Bond Purchase",
        "commission": 125.89,
        "tradeDate": "2024-07-01",
        "unitPrice": 99.485,
        "units": 350000,
        "valueDate": "2024-07-02"
      },
      "relationships": {
        "account": {
          "data": {
            "type": "account",
            "id": "6698ffbdda04cf5d2d55a265"
          }
        },
        "asset": {
          "data": {
            "type": "asset",
            "id": "b5afc699f5e3a15556d2a00c"
          }
        },
        "depository": {
          "data": {
            "type": "depository",
            "id": "6698ffae47a5a2c8b2554ee8"
          }
        }
      }
    }
  ]
}
Cash Transfer Transaction​
200 OK 
# Request
GET /api/v2/transactions
  ?accountId=6698ffbdda04cf5d2d55a265
  &fromDate=2024-07-01
  &toDate=2024-07-01 HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Host: platform.aleta.io


# Response
HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
  "data": [
    {
      "id": "66990014c5dc848e8f97c1bb",
      "type": "cash-transfer-transaction",
      "attributes": {
        "accountAmount": -250000,
        "comment": "Transfer to external account",
        "tradeDate": "2024-07-01",
        "valueDate": "2024-07-01"
      },
      "relationships": {
        "account": {
          "data": {
            "type": "account",
            "id": "6698ffbdda04cf5d2d55a265"
          }
        }
      }
    }
  ]
}
Dividend Transaction​
200 OK 
# Request
GET /api/v2/transactions
  ?accountId=6698ffbdda04cf5d2d55a265
  &fromDate=2024-07-01
  &toDate=2024-07-01 HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Host: platform.aleta.io


# Response
HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
  "data": [
    {
      "id": "66990014c5dc848e8f97c1bb",
      "type": "dividend-transaction",
      "attributes": {
        "accountAmount": 12994.21,
        "comment": "Dividend",
        "commission": 0,
        "grossAmount": 16659.25,
        "tax": 3665.04,
        "tradeDate": "2024-07-01",
        "valueDate": "2024-07-01"
      },
      "relationships": {
        "account": {
          "data": {
            "type": "account",
            "id": "6698ffbdda04cf5d2d55a265"
          }
        },
        "asset": {
          "data": {
            "type": "asset",
            "id": "b5afc699f5e3a15556d2a00c"
          }
        },
        "depository": {
          "data": {
            "type": "depository",
            "id": "6698ffae47a5a2c8b2554ee8"
          }
        }
      }
    }
  ]
}
Equity Trade Transaction​
200 OK 
# Request
GET /api/v2/transactions
  ?accountId=6698ffbdda04cf5d2d55a265
  &fromDate=2024-07-01
  &toDate=2024-07-01 HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Host: platform.aleta.io


# Response
HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
  "data": [
    {
      "id": "66990014c5dc848e8f97c1bb",
      "type": "equity-trade-transaction",
      "attributes": {
        "accountAmount": 2961796.6,
        "comment": "Equity Sell",
        "commission": 199,
        "tradeDate": "2024-07-01",
        "unitPrice": 398,
        "units": -1000,
        "valueDate": "2024-07-01"
      },
      "relationships": {
        "account": {
          "data": {
            "type": "account",
            "id": "6698ffbdda04cf5d2d55a265"
          }
        },
        "asset": {
          "data": {
            "type": "asset",
            "id": "b5afc699f5e3a15556d2a00c"
          }
        },
        "depository": {
          "data": {
            "type": "depository",
            "id": "6698ffae47a5a2c8b2554ee8"
          }
        }
      }
    }
  ]
}
Fee Transaction​
200 OK 
# Request
GET /api/v2/transactions
  ?accountId=6698ffbdda04cf5d2d55a265
  &fromDate=2024-07-01
  &toDate=2024-07-01 HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Host: platform.aleta.io


# Response
HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
  "data": [
    {
      "id": "66990014c5dc848e8f97c1bb",
      "type": "fee-transaction",
      "attributes": {
        "accountAmount": -20078.21,
        "category": "management",
        "comment": "Fee Q2",
        "tradeDate": "2024-07-01",
        "valueDate": "2024-07-01"
      },
      "relationships": {
        "account": {
          "data": {
            "type": "account",
            "id": "6698ffbdda04cf5d2d55a265"
          }
        }
      }
    }
  ]
}
Futures Trade Transaction​
200 OK 
# Request
GET /api/v2/transactions
  ?accountId=6698ffbdda04cf5d2d55a265
  &fromDate=2024-07-01
  &toDate=2024-07-01 HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Host: platform.aleta.io


# Response
HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
  "data": [
    {
      "id": "66990014c5dc848e8f97c1bb",
      "type": "futures-trade-transaction",
      "attributes": {
        "accountAmount": -120,
        "comment": "Futures Buy",
        "commission": 120,
        "tradeDate": "2024-07-01",
        "unitPrice": 582.5,
        "units": 209,
        "valueDate": "2024-07-01"
      },
      "relationships": {
        "account": {
          "data": {
            "type": "account",
            "id": "6698ffbdda04cf5d2d55a265"
          }
        },
        "asset": {
          "data": {
            "type": "asset",
            "id": "b5afc699f5e3a15123d2a456"
          }
        },
        "depository": {
          "data": {
            "type": "depository",
            "id": "6698ffae47a5a2c8b2554ee8"
          }
        }
      }
    }
  ]
}
Futures Execution Transaction​
200 OK 
# Request
GET /api/v2/transactions
  ?accountId=6698ffbdda04cf5d2d55a265
  &fromDate=2025-01-01
  &toDate=2025-01-01 HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Host: platform.aleta.io


# Response
HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
  "data": [
    {
      "id": "66990014c5dc848e8f97c1bc",
      "type": "futures-execution-transaction",
      "attributes": {
        "accountAmount": 1990,
        "comment": "Futures execution",
        "commission": 100,
        "tradeDate": "2025-01-01",
        "unitPrice": 592.5,
        "units": -209,
        "valueDate": "2025-01-01"
      },
      "relationships": {
        "account": {
          "data": {
            "type": "account",
            "id": "6698ffbdda04cf5d2d55a265"
          }
        },
        "asset": {
          "data": {
            "type": "asset",
            "id": "b5afc699f5e3a15123d2a456"
          }
        },
        "depository": {
          "data": {
            "type": "depository",
            "id": "6698ffae47a5a2c8b2554ee8"
          }
        },
        "openingTransaction": {
          "data": {
            "type": "transaction",
            "id": "66990014c5dc848e8f97c1bb"
          }
        }
      }
    }
  ]
}
FX Forward Cash Settlement Transaction​
200 OK 
# Request
GET /api/v2/transactions
  ?accountId=a3088d3da462cdd045c7a4bf
  &fromDate=2024-06-03
  &toDate=2024-06-03 HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Host: platform.aleta.io


# Response
HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
  "data": [
    {
      "id": "66990014c5dc848e8f97c1bb",
      "type": "fx-forward-cash-settlement-transaction",
      "attributes": {
        "accountAmount": -11440,
        "tradeDate": "2024-06-03",
        "valueDate": "2024-06-03"
      },
      "relationships": {
        "account": {
          "data": {
            "type": "account",
            "id": "a3088d3da462cdd045c7a4bf"
          }
        },
        "fxForward": {
          "data": {
            "type": "asset",
            "id": "1d126d9bb1e2450bbffcbb00"
          }
        }
      }
    }
  ]
}
FX Forward Physical Delivery Transaction​
200 OK 
# Request
GET /api/v2/transactions
  ?accountId=d30fa8c3d32f01ffcba161c5
  &fromDate=2024-11-30
  &toDate=2024-11-30 HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Host: platform.aleta.io


# Response
HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
  "data": [
    {
      "id": "66990014c5dc848e8f97c1bb",
      "type": "fx-forward-physical-delivery-transaction",
      "attributes": {
        "primaryAccountAmount": 100000,
        "secondaryAccountAmount": -666210,
        "tradeDate": "2024-11-30",
        "valueDate": "2024-11-30"
      },
      "relationships": {
        "primaryAccount": {
          "data": {
            "type": "account",
            "id": "d30fa8c3d32f01ffcba161c5"
          }
        },
        "secondaryAccount": {
          "data": {
            "type": "account",
            "id": "ff11ebc533672061e282e71e"
          }
        },
        "fxForward": {
          "data": {
            "type": "asset",
            "id": "cc4bda6ebab880fdb125f071"
          }
        }
      }
    }
  ]
}
FX Spot Transaction​
200 OK
# Request
GET /api/v2/transactions
  ?accountId=2d5f51a2a3af2c5069e54247
  &fromDate=2024-09-25
  &toDate=2024-09-25 HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Host: platform.aleta.io


# Response
HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
  "data": [
    {
      "id": "0fa86d74eacffcf1be6ef90d",
      "type": "fx-spot-transaction",
      "attributes": {
        "comment": "USD 100,000.00 to DKK 666,210.00",
        "inflowAccountAmount": 666210,
        "outflowAccountAmount": -100000,
        "tradeDate": "2024-09-25",
        "valueDate": "2024-09-25"
      },
      "relationships": {
        "inflowAccount": {
          "data": {
            "type": "account",
            "id": "2d5f51a2a3af2c5069e54247"
          }
        },
        "outflowAccount": {
          "data": {
            "type": "account",
            "id": "b5afc699f5e3a15556d2a00c"
          }
        }
      }
    }
  ]
}
Index-Linked Bond Coupon Transaction​
200 OK 
# Request
GET /api/v2/transactions
  ?accountId=6698ffbdda04cf5d2d55a265
  &fromDate=2024-07-01
  &toDate=2024-07-01 HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Host: platform.aleta.io


# Response
HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
  "data": [
    {
      "id": "66990014c5dc848e8f97c1bb",
      "type": "index-linked-bond-coupon-transaction",
      "attributes": {
        "accountAmount": 6438.79,
        "comment": "Index-Linked Bond Coupon",
        "grossAmount": 5500.00,
        "indexFactor": 117.0689,
        "tradeDate": "2024-07-01",
        "valueDate": "2024-07-01"
      },
      "relationships": {
        "account": {
          "data": {
            "type": "account",
            "id": "6698ffbdda04cf5d2d55a265"
          }
        },
        "asset": {
          "data": {
            "type": "asset",
            "id": "b5afc699f5e3a15556d2a00c"
          }
        },
        "depository": {
          "data": {
            "type": "depository",
            "id": "6698ffae47a5a2c8b2554ee8"
          }
        }
      }
    }
  ]
}
Index-Linked Bond Redemption Transaction​
200 OK 
# Request
GET /api/v2/transactions
  ?accountId=6698ffbdda04cf5d2d55a265
  &fromDate=2024-07-01
  &toDate=2024-07-01 HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Host: platform.aleta.io


# Response
HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
  "data": [
    {
      "id": "66990014c5dc848e8f97c1bb",
      "type": "index-linked-bond-redemption-transaction",
      "attributes": {
        "accountAmount": 26297080.00,
        "comment": "Index-Linked Bond Redemption",
        "indexFactor": 122.312,
        "tradeDate": "2024-07-01",
        "unitPrice": 100.00,
        "units": -21500000.00,
        "valueDate": "2024-07-01"
      },
      "relationships": {
        "account": {
          "data": {
            "type": "account",
            "id": "6698ffbdda04cf5d2d55a265"
          }
        },
        "asset": {
          "data": {
            "type": "asset",
            "id": "b5afc699f5e3a15556d2a00c"
          }
        },
        "depository": {
          "data": {
            "type": "depository",
            "id": "6698ffae47a5a2c8b2554ee8"
          }
        }
      }
    }
  ]
}
Index-Linked Bond Trade Transaction​
200 OK 
# Request
GET /api/v2/transactions
  ?accountId=6698ffbdda04cf5d2d55a265
  &fromDate=2024-07-01
  &toDate=2024-07-01 HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Host: platform.aleta.io


# Response
HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
  "data": [
    {
      "id": "66990014c5dc848e8f97c1bb",
      "type": "index-linked-bond-trade-transaction",
      "attributes": {
        "accountAmount": 6269007.91,
        "accruedInterest": 3703.71,
        "comment": "Index-Linked Bond Sale",
        "commission": 0.0,
        "indexFactor": 118.169,
        "tradeDate": "2024-07-01",
        "unitPrice": 96.3997510,
        "units": -5500000,
        "valueDate": "2024-07-02"
      },
      "relationships": {
        "account": {
          "data": {
            "type": "account",
            "id": "6698ffbdda04cf5d2d55a265"
          }
        },
        "asset": {
          "data": {
            "type": "asset",
            "id": "b5afc699f5e3a15556d2a00c"
          }
        },
        "depository": {
          "data": {
            "type": "depository",
            "id": "6698ffae47a5a2c8b2554ee8"
          }
        }
      }
    }
  ]
}
Loan Transaction​
200 OK
# Request
GET /api/v2/transactions
  ?accountId=2d5f51a2a3af2c5069e54247
  &fromDate=2024-09-25
  &toDate=2024-09-25 HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Host: platform.aleta.io


# Response
HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
  "data": [
    {
      "id": "0fa86d74eacffcf1be6ef90d",
      "type": "loan-transaction",
      "attributes": {
        "accountAmount": -101000,
        "interest": -1000,
        "tradeDate": "2024-09-25",
        "valueDate": "2024-09-25"
      },
      "relationships": {
        "account": {
          "data": {
            "type": "account",
            "id": "2d5f51a2a3af2c5069e54247"
          }
        },
        "loan": {
          "data": {
            "type": "asset",
            "id": "2d5f51a2a3af2c5069e54248"
          }
        }
      }
    }
  ]
}
Private Market Fund Distribution Transaction​
200 OK 
# Request
GET /api/v2/transactions
  ?accountId=6698ffbdda04cf5d2d55a265
  &fromDate=2025-07-01
  &toDate=2025-07-01 HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Host: platform.aleta.io


# Response
HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
  "data": [
    {
      "id": "6698ffbdda04cf5d2d55a263",
      "type": "private-market-fund-distribution-transaction",
      "attributes": {
        "category": "return-of-capital",
        "amount": 1000,
        "recallableAmount": 0,
        "affectsEstimatedNav": true,
        "affectsMultiples": true,
        "affectsIrr": true,
        "affectsCostBase": true,
        "accountAmount": 1200,
        "comment": "Return of Capital transaction",
        "tradeDate": "2025-07-01",
        "valueDate": "2025-07-01"
      },
      "relationships": {
        "instrument": {
          "data": {
            "type": "private-market-fund-commitment-based-instrument",
            "id": "6698ffbdda04cf5d2d55a264"
          }
        },
        "account": {
          "data": {
            "type": "account",
            "id": "6698ffbdda04cf5d2d55a265"
          }
        }
      }
    }
  ]
}
Private Market Fund Drawdown Transaction​
200 OK 
# Request
GET /api/v2/transactions
  ?accountId=6698ffbdda04cf5d2d55a265
  &fromDate=2025-07-01
  &toDate=2025-07-01 HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Host: platform.aleta.io


# Response
HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
  "data": [
    {
      "id": "6698ffbdda04cf5d2d55a263",
      "type": "private-market-fund-drawdown-transaction",
      "attributes": {
        "category": "capital-call",
        "amount": 1000,
        "effectOnUnfundedCommitment": -1000,
        "affectsEstimatedNav": true,
        "affectsMultiples": true,
        "affectsIrr": true,
        "affectsCostBase": true,
        "accountAmount": -1200,
        "comment": "Capital Call transaction",
        "tradeDate": "2025-07-01",
        "valueDate": "2025-07-01"
      },
      "relationships": {
        "instrument": {
          "data": {
            "type": "private-market-fund-commitment-based-instrument",
            "id": "6698ffbdda04cf5d2d55a264"
          }
        },
        "account": {
          "data": {
            "type": "account",
            "id": "6698ffbdda04cf5d2d55a265"
          }
        }
      }
    }
  ]
}
Refund Transaction​
200 OK 
# Request
GET /api/v2/transactions
  ?accountId=6698ffbdda04cf5d2d55a265
  &fromDate=2024-07-01
  &toDate=2024-07-01 HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Host: platform.aleta.io


# Response
HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
  "data": [
    {
      "id": "66990014c5dc848e8f97c1bb",
      "type": "refund-transaction",
      "attributes": {
        "accountAmount": 5457.15,
        "comment": "Portfolio Management Fee Rebate Q2",
        "tradeDate": "2024-07-01",
        "valueDate": "2024-07-01"
      },
      "relationships": {
        "account": {
          "data": {
            "type": "account",
            "id": "6698ffbdda04cf5d2d55a265"
          }
        }
      }
    }
  ]
}
Zero Coupon Bond Trade Transaction​
200 OK 
# Request
GET /api/v2/transactions
  ?accountId=6698ffbdda04cf5d2d55a265
  &fromDate=2024-07-01
  &toDate=2024-07-01 HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Host: platform.aleta.io


# Response
HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
  "data": [
    {
      "id": "66990014c5dc848e8f97c1bb",
      "type": "zero-coupon-bond-trade-transaction",
      "attributes": {
        "accountAmount": 5301986.31,
        "comment": "Zero Coupon Bond Sale",
        "commission": 0.0,
        "tradeDate": "2024-07-01",
        "unitPrice": 96.3997510,
        "units": -5500000,
        "valueDate": "2024-07-02"
      },
      "relationships": {
        "account": {
          "data": {
            "type": "account",
            "id": "6698ffbdda04cf5d2d55a265"
          }
        },
        "asset": {
          "data": {
            "type": "asset",
            "id": "b5afc699f5e3a15556d2a00c"
          }
        },
        "depository": {
          "data": {
            "type": "depository",
            "id": "6698ffae47a5a2c8b2554ee8"
          }
        }
      }
    }
  ]
}

POST /transactions​

Create a new transaction for an account.

Examples​

Bond Coupon Transaction​
201 Created 
# Request
POST /api/v2/transactions HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Content-Type: application/vnd.json+api
Host: platform.aleta.io

{
  "data": {
    "type": "bond-coupon-transaction",
    "attributes": {
      "accountAmount": 7500.00,
      "comment": "Bond Coupon",
      "grossAmount": 7500.00,
      "tradeDate": "2024-07-01",
      "valueDate": "2024-07-01"
    },
    "relationships": {
      "account": {
        "data": {
          "type": "account",
          "id": "6698ffbdda04cf5d2d55a265"
        }
      },
      "asset": {
        "data": {
          "type": "asset",
          "id": "b5afc699f5e3a15556d2a00c"
        }
      },
      "depository": {
        "data": {
          "type": "depository",
          "id": "6698ffae47a5a2c8b2554ee8"
        }
      }
    }
  }
}

# Response
HTTP/1.1 201 Created
Content-Type: application/vnd.json+api

{
  "data": {
    "id": "66990014c5dc848e8f97c1bb",
    "type": "bond-coupon-transaction",
    "attributes": {
      "accountAmount": 7500.00,
      "comment": "Bond Coupon",
      "grossAmount": 7500.00,
      "tradeDate": "2024-07-01",
      "valueDate": "2024-07-01"
    },
    "relationships": {
      "account": {
        "data": {
          "type": "account",
          "id": "6698ffbdda04cf5d2d55a265"
        }
      },
      "asset": {
        "data": {
          "type": "asset",
          "id": "b5afc699f5e3a15556d2a00c"
        }
      },
      "depository": {
        "data": {
          "type": "depository",
          "id": "6698ffae47a5a2c8b2554ee8"
        }
      }
    }
  }
}
Bond Redemption Transaction​
201 Created 
# Request
POST /api/v2/transactions HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Content-Type: application/vnd.json+api
Host: platform.aleta.io

{
  "data": {
    "type": "bond-redemption-transaction",
    "attributes": {
      "accountAmount": 50000.00,
      "comment": "Bond Redemption",
      "tradeDate": "2024-07-01",
      "unitPrice": 100.00,
      "units": -50000.00,
      "valueDate": "2024-07-01"
    },
    "relationships": {
      "account": {
        "data": {
          "type": "account",
          "id": "6698ffbdda04cf5d2d55a265"
        }
      },
      "asset": {
        "data": {
          "type": "asset",
          "id": "b5afc699f5e3a15556d2a00c"
        }
      },
      "depository": {
        "data": {
          "type": "depository",
          "id": "6698ffae47a5a2c8b2554ee8"
        }
      }
    }
  }
}

# Response
HTTP/1.1 201 Created
Content-Type: application/vnd.json+api

{
  "data": {
    "id": "66990014c5dc848e8f97c1bb",
    "type": "bond-redemption-transaction",
    "attributes": {
      "accountAmount": 50000.00,
      "comment": "Bond Redemption",
      "tradeDate": "2024-07-01",
      "unitPrice": 100.00,
      "units": -50000.00,
      "valueDate": "2024-07-01"
    },
    "relationships": {
      "account": {
        "data": {
          "type": "account",
          "id": "6698ffbdda04cf5d2d55a265"
        }
      },
      "asset": {
        "data": {
          "type": "asset",
          "id": "b5afc699f5e3a15556d2a00c"
        }
      },
      "depository": {
        "data": {
          "type": "depository",
          "id": "6698ffae47a5a2c8b2554ee8"
        }
      }
    }
  }
}
Bond Trade Transaction​
201 Created 
# Request
POST /api/v2/transactions HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Content-Type: application/vnd.json+api
Host: platform.aleta.io

{
  "data": {
    "type": "bond-trade-transaction",
    "attributes": {
      "accountAmount": -349234.22,
      "accruedInterest": -910.83,
      "comment": "Bond Purchase",
      "commission": 125.89,
      "tradeDate": "2024-07-01",
      "unitPrice": 99.485,
      "units": 350000,
      "valueDate": "2024-07-01"
    },
    "relationships": {
      "account": {
        "data": {
          "type": "account",
          "id": "6698ffbdda04cf5d2d55a265"
        }
      },
      "asset": {
        "data": {
          "type": "asset",
          "id": "b5afc699f5e3a15556d2a00c"
        }
      },
      "depository": {
        "data": {
          "type": "depository",
          "id": "6698ffae47a5a2c8b2554ee8"
        }
      }
    }
  }
}

# Response
HTTP/1.1 201 Created
Content-Type: application/vnd.json+api

{
  "data": {
    "id": "66990014c5dc848e8f97c1bb",
    "type": "bond-trade-transaction",
    "attributes": {
      "accountAmount": -349234.22,
      "accruedInterest": -910.83,
      "comment": "Bond Purchase",
      "commission": 125.89,
      "tradeDate": "2024-07-01",
      "unitPrice": 99.485,
      "units": 350000,
      "valueDate": "2024-07-02"
    },
    "relationships": {
      "account": {
        "data": {
          "type": "account",
          "id": "6698ffbdda04cf5d2d55a265"
        }
      },
      "asset": {
        "data": {
          "type": "asset",
          "id": "b5afc699f5e3a15556d2a00c"
        }
      },
      "depository": {
        "data": {
          "type": "depository",
          "id": "6698ffae47a5a2c8b2554ee8"
        }
      }
    }
  }
}
Cash Transfer Transaction​
External Cash Transfer​
201 Created 
# Request
POST /api/v2/transactions HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Content-Type: application/vnd.json+api
Host: platform.aleta.io

{
  "data": {
    "type": "cash-transfer-transaction",
    "attributes": {
      "accountAmount": -250000,
      "comment": "Transfer to external account",
      "tradeDate": "2024-07-01",
      "valueDate": "2024-07-01"
    },
    "relationships": {
      "account": {
        "data": {
          "type": "account",
          "id": "6698ffbdda04cf5d2d55a265"
        }
      }
    }
  }
}

# Response
HTTP/1.1 201 Created
Content-Type: application/vnd.json+api

{
  "data": {
    "id": "66990014c5dc848e8f97c1bb",
    "type": "cash-transfer-transaction",
    "attributes": {
      "accountAmount": -250000,
      "comment": "Transfer to external account",
      "tradeDate": "2024-07-01",
      "valueDate": "2024-07-01"
    },
    "relationships": {
      "account": {
        "data": {
          "type": "account",
          "id": "6698ffbdda04cf5d2d55a265"
        }
      }
    }
  }
}
Internal Cash Transfer​

For an internal cash transfer, you will need to create each leg of the transaction separately.

  1. For the first leg, create a transaction in the same way as an external cash transfer.
  2. For the second leg, include the counterparty-transaction object in the relationships section and set it to the ID of the transaction created as the first leg. When you send the POST request for the second leg, the transaction referenced in the counterparty-transaction will be automatically updated, and a counterparty-transaction object will also be added to that initial transaction.
201 Created 
# Request
POST /api/v2/transactions HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Content-Type: application/vnd.json+api
Host: platform.aleta.io

{
  "data": {
    "type": "cash-transfer-transaction",
    "attributes": {
      "accountAmount": 100000,
      "comment": "Transfer from account 1 to account 2",
      "tradeDate": "2024-07-01",
      "valueDate": "2024-07-01"
    },
    "relationships": {
      "account": {
        "data": {
          "type": "account",
          "id": "6698ffbdda04cf5d2d55a265"
        }
      },
      "counterparty-transaction": {
        "data": {
          "type": "cash-transfer-transaction",
          "id": "66990014c5dc848e8f97c1bb"
        }
      }
    }
  }
}

# Response
HTTP/1.1 201 Created
Content-Type: application/vnd.json+api

{
  "data": {
    "id": "66990014c5dc848e8f97c1bb",
    "type": "cash-transfer-transaction",
    "attributes": {
      "accountAmount": 100000,
      "comment": "Transfer from account 1 to account 2",
      "tradeDate": "2024-07-01",
      "valueDate": "2024-07-01"
    },
    "relationships": {
      "account": {
        "data": {
          "type": "account",
          "id": "6698ffbdda04cf5d2d55a265"
        }
      },
      "counterparty-transaction": {
        "data": {
          "type": "cash-transfer-transaction",
          "id": "66990014c5dc848e8f97c1bb"
        }
      }
    }
  }
}
Dividend Transaction​
201 Created 
# Request
POST /api/v2/transactions HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Content-Type: application/vnd.json+api
Host: platform.aleta.io

{
  "data": {
    "type": "dividend-transaction",
    "attributes": {
      "accountAmount": 12994.21,
      "comment": "Dividend",
      "commission": 0,
      "grossAmount": 16659.25,
      "tax": 3665.04,
      "tradeDate": "2024-07-01",
      "valueDate": "2024-07-01"
    },
    "relationships": {
      "account": {
        "data": {
          "type": "account",
          "id": "6698ffbdda04cf5d2d55a265"
        }
      },
      "asset": {
        "data": {
          "type": "asset",
          "id": "b5afc699f5e3a15556d2a00c"
        }
      },
      "depository": {
        "data": {
          "type": "depository",
          "id": "6698ffae47a5a2c8b2554ee8"
        }
      }
    }
  }
}

# Response
HTTP/1.1 201 Created
Content-Type: application/vnd.json+api

{
  "data": {
    "id": "66990014c5dc848e8f97c1bb",
    "type": "dividend-transaction",
    "attributes": {
      "accountAmount": 12994.21,
      "comment": "Dividend",
      "commissions": 0,
      "grossAmount": 16659.25,
      "tax": 3665.04,
      "tradeDate": "2024-07-01",
      "valueDate": "2024-07-01"
    },
    "relationships": {
      "account": {
        "data": {
          "type": "account",
          "id": "6698ffbdda04cf5d2d55a265"
        }
      },
      "asset": {
        "data": {
          "type": "asset",
          "id": "b5afc699f5e3a15556d2a00c"
        }
      },
      "depository": {
        "data": {
          "type": "depository",
          "id": "6698ffae47a5a2c8b2554ee8"
        }
      }
    }
  }
}
Equity Trade Transaction​
201 Created 
# Request
POST /api/v2/transactions HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Content-Type: application/vnd.json+api
Host: platform.aleta.io

{
  "data": {
    "type": "equity-trade-transaction",
    "attributes": {
      "accountAmount": 397801,
      "comment": "Equity Sell",
      "commission": 199,
      "tradeDate": "2024-07-01",
      "unitPrice": 398,
      "units": -1000,
      "valueDate": "2024-07-01"
    },
    "relationships": {
      "account": {
        "data": {
          "type": "account",
          "id": "6698ffbdda04cf5d2d55a265"
        }
      },
      "asset": {
        "data": {
          "type": "asset",
          "id": "b5afc699f5e3a15556d2a00c"
        }
      },
      "depository": {
        "data": {
          "type": "depository",
          "id": "6698ffae47a5a2c8b2554ee8"
        }
      }
    }
  }
}

# Response
HTTP/1.1 201 Created
Content-Type: application/vnd.json+api

{
  "data": {
    "id": "66990014c5dc848e8f97c1bb",
    "type": "equity-trade-transaction",
    "attributes": {
      "accountAmount": 397801,
      "comment": "Equity Sell",
      "commission": 199,
      "tradeDate": "2024-07-01",
      "unitPrice": 398,
      "units": -1000,
      "valueDate": "2024-07-01"
    },
    "relationships": {
      "account": {
        "data": {
          "type": "account",
          "id": "6698ffbdda04cf5d2d55a265"
        }
      },
      "asset": {
        "data": {
          "type": "asset",
          "id": "b5afc699f5e3a15556d2a00c"
        }
      },
      "depository": {
        "data": {
          "type": "depository",
          "id": "6698ffae47a5a2c8b2554ee8"
        }
      }
    }
  }
}
Fee Transaction​
201 Created
# Request
POST /api/v2/transactions HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Content-Type: application/vnd.json+api
Host: platform.aleta.io

{
  "data": {
    "type": "fee-transaction",
    "attributes": {
      "accountAmount": -100,
      "category": "management",
      "comment": "PM fee",
      "tradeDate": "2025-03-25",
      "valueDate": "2025-03-25"
    },
    "relationships": {
      "account": {
        "data": {
          "type": "account",
          "id": "6698ffbdda04cf5d2d55a265"
        }
      }
    }
  }
}

# Response
HTTP/1.1 201 Created
Content-Type: application/vnd.json+api

{
  "data": {
    "id": "66990014c5dc848e8f97c1bb",
    "type": "fee-transaction",
    "attributes": {
      "accountAmount": -100,
      "category": "management",
      "comment": "PM fee",
      "tradeDate": "2025-03-25",
      "valueDate": "2025-03-25"
    },
    "relationships": {
      "account": {
        "data": {
          "type": "account",
          "id": "6698ffbdda04cf5d2d55a265"
        }
      }
    }
  }
}
FX Spot Transaction​
201 Created
# Request
POST /api/v2/transactions HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Content-Type: application/vnd.json+api
Host: platform.aleta.io

{
  "data": {
    "type": "fx-spot-transaction",
    "attributes": {
      "comment": "USD 100,000.00 to DKK 666,210.00",
      "inflowAccountAmount": 666210,
      "outflowAccountAmount": -100000,
      "tradeDate": "2024-09-25",
      "valueDate": "2024-09-25"
    },
    "relationships": {
      "inflowAccount": {
        "data": {
          "type": "account",
          "id": "2d5f51a2a3af2c5069e54247"
        }
      },
      "outflowAccount": {
        "data": {
          "type": "account",
          "id": "b5afc699f5e3a15556d2a00c"
        }
      }
    }
  }
}

# Response
HTTP/1.1 201 Created
Content-Type: application/vnd.json+api

{
  "data": {
    "id": "678f4721b9d8a1ba302bdefe",
    "type": "fx-spot-transaction",
    "attributes": {
      "comment": "USD 100,000.00 to DKK 666,210.00",
      "inflowAccountAmount": 666210,
      "outflowAccountAmount": -100000,
      "tradeDate": "2024-09-25",
      "valueDate": "2024-09-25"
    },
    "relationships": {
      "inflowAccount": {
        "data": {
          "type": "account",
          "id": "2d5f51a2a3af2c5069e54247"
        }
      },
      "outflowAccount": {
        "data": {
          "type": "account",
          "id": "b5afc699f5e3a15556d2a00c"
        }
      }
    }
  }
}
Private Market Fund Distribution Transaction​
201 Created 
# Request
POST /api/v2/transactions HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Content-Type: application/vnd.json+api
Host: platform.aleta.io

{
  "data": {
    "type": "private-market-fund-distribution-transaction",
    "attributes": {
      "category": "return-of-capital",
      "amount": 1000,
      "recallableAmount": 0,
      "affectsEstimatedNav": true,
      "affectsMultiples": true,
      "affectsIrr": true,
      "affectsCostBase": true,
      "accountAmount": 1200,
      "comment": "Return of Capital transaction",
      "tradeDate": "2025-07-01",
      "valueDate": "2025-07-01"
    },
    "relationships": {
      "instrument": {
        "data": {
          "type": "private-market-fund-commitment-based-instrument",
          "id": "6698ffbdda04cf5d2d55a264"
        }
      },
      "account": {
        "data": {
          "type": "account",
          "id": "6698ffbdda04cf5d2d55a265"
        }
      }
    }
  }
}
# Response
HTTP/1.1 201 Created
Content-Type: application/vnd.json+api

{
  "data": {
    "id": "6698ffbdda04cf5d2d55a263",
    "type": "private-market-fund-distribution-transaction",
    "attributes": {
      "category": "return-of-capital",
      "amount": 1000,
      "recallableAmount": 0,
      "affectsEstimatedNav": true,
      "affectsMultiples": true,
      "affectsIrr": true,
      "affectsCostBase": true,
      "accountAmount": 1200,
      "comment": "Return of Capital transaction",
      "tradeDate": "2025-07-01",
      "valueDate": "2025-07-01"
    },
    "relationships": {
      "instrument": {
        "data": {
          "type": "private-market-fund-commitment-based-instrument",
          "id": "6698ffbdda04cf5d2d55a264"
        }
      },
      "account": {
        "data": {
          "type": "account",
          "id": "6698ffbdda04cf5d2d55a265"
        }
      }
    }
  }
}
Private Market Fund Drawdown Transaction​
201 Created 
# Request
POST /api/v2/transactions HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Content-Type: application/vnd.json+api
Host: platform.aleta.io

{
  "data": {
    "type": "private-market-fund-drawdown-transaction",
    "attributes": {
      "category": "capital-call",
      "amount": 1000,
      "effectOnUnfundedCommitment": -1000,
      "affectsEstimatedNav": true,
      "affectsMultiples": true,
      "affectsIrr": true,
      "affectsCostBase": true,
      "accountAmount": -1200,
      "comment": "Capital Call transaction",
      "tradeDate": "2025-07-01",
      "valueDate": "2025-07-01"
    },
    "relationships": {
      "instrument": {
        "data": {
          "type": "private-market-fund-commitment-based-instrument",
          "id": "6698ffbdda04cf5d2d55a264"
        }
      },
      "account": {
        "data": {
          "type": "account",
          "id": "6698ffbdda04cf5d2d55a265"
        }
      }
    }
  }
}
# Response
HTTP/1.1 201 Created
Content-Type: application/vnd.json+api

{
  "data": {
    "type": "private-market-fund-drawdown-transaction",
    "id": "6698ffbdda04cf5d2d55a263",
    "attributes": {
      "category": "capital-call",
      "amount": 1000,
      "effectOnUnfundedCommitment": -1000,
      "affectsEstimatedNav": true,
      "affectsMultiples": true,
      "affectsIrr": true,
      "affectsCostBase": true,
      "accountAmount": -1200,
      "comment": "Capital Call transaction",
      "tradeDate": "2025-07-01",
      "valueDate": "2025-07-01"
    },
    "relationships": {
      "instrument": {
        "data": {
          "type": "private-market-fund-commitment-based-instrument",
          "id": "6698ffbdda04cf5d2d55a264"
        }
      },
      "account": {
        "data": {
          "type": "account",
          "id": "6698ffbdda04cf5d2d55a265"
        }
      }
    }
  }
}
Zero Coupon Bond Trade Transaction​
201 Created 
# Request
POST /api/v2/transactions HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Content-Type: application/vnd.json+api
Host: platform.aleta.io

{
  "data": {
    "type": "zero-coupon-bond-trade-transaction",
    "attributes": {
      "accountAmount": -349234.22,
      "comment": "Zero Coupon Bond Purchase",
      "commission": 125.89,
      "tradeDate": "2024-07-01",
      "unitPrice": 99.485,
      "units": 350000,
      "valueDate": "2024-07-01"
    },
    "relationships": {
      "account": {
        "data": {
          "type": "account",
          "id": "6698ffbdda04cf5d2d55a265"
        }
      },
      "asset": {
        "data": {
          "type": "asset",
          "id": "b5afc699f5e3a15556d2a00c"
        }
      },
      "depository": {
        "data": {
          "type": "depository",
          "id": "6698ffae47a5a2c8b2554ee8"
        }
      }
    }
  }
}

# Response
HTTP/1.1 201 Created
Content-Type: application/vnd.json+api

{
  "data": {
    "id": "66990014c5dc848e8f97c1bb",
    "type": "zero-coupon-bond-trade-transaction",
    "attributes": {
      "accountAmount": -349234.22,
      "comment": "Zero Coupon Bond Purchase",
      "commission": 125.89,
      "tradeDate": "2024-07-01",
      "unitPrice": 99.485,
      "units": 350000,
      "valueDate": "2024-07-01"
    },
    "relationships": {
      "account": {
        "data": {
          "type": "account",
          "id": "6698ffbdda04cf5d2d55a265"
        }
      },
      "asset": {
        "data": {
          "type": "asset",
          "id": "b5afc699f5e3a15556d2a00c"
        }
      },
      "depository": {
        "data": {
          "type": "depository",
          "id": "6698ffae47a5a2c8b2554ee8"
        }
      }
    }
  }
}

DELETE /transactions/:id​

Delete a transaction with a given id.

Parameters​

  • id (path, required): Identifier for the specific transaction that needs to be deleted.
info

If a cash transfer transaction being deleted has a counterparty transaction (i.e., a linked transaction in a different account), only the transaction with the id provided in the request will be deleted. The counterparty transaction will automatically be updated to remove the counterparty-transaction relationship object.

Examples​

204 No Content 
# Request
DELETE /api/v2/transactions/66990014c5dc848e8f97c1bb HTTP/1.1
Accept: application/vnd.json+api
Authorization: Bearer <access token>
Host: platform.aleta.io


# Response
HTTP/1.1 204 No Content