Transactions

• Transactions

Transactions

Table of Contents

• Description
• Examples
• Cookbook
• F.A.Q.
• API Documentation

Description

Financial meaning

Transactions in an investment platform represent any economic activity that results in a change of ownership, value, or cash position of financial instruments or related accounts. They are the building blocks of portfolio management, accounting, performance analysis, and compliance. 

Platform abstraction

Transaction in the Finmars platform is a fundamental entity that represents any economic action involving a financial instrument, cash, or both. Transactions serve as the source of truth for portfolio activity, capturing events such as purchases, sales, income, redemptions, and other movements.

Transaction also is used in:

• valuation, serving as inputs for position lifecycle, pricing, and performance.

• reconciliation, comparing expected vs. actual positions and cash events.

• reporting, providing raw and derived data for trade activity, cash analysis, and compliance.

• accounting, enabling P&L, fee, tax, and ledger mapping through transaction classification.

Examples

First part of table

TXN ID	Date	Source	Date (Trade)	Description	Date (Value)	TXN TYPE	CCY STL	Cash Consideration	Instrument
20240125001.0	2025-02-13	std.file	2022-12-03	Buy : Instrument: TREASURY BILL 0.00%	2022-12-05	Buy	USD	-1'654'021.90	TREASURY BILL 0.00% 25-Jan-2024

Second part of table

ISIN	Position (Adjusted)	Account (Cash)	Portfolio	Status (Reversed)	Status (Cancelled)	Reference Transaction ID	Allocation (PL)	Linked Instruments	Notes
USP	-303.90	US4508411200000	CH-BND-203948	0.0	-	None	TREASURY BILL 0.00% 25-Jan-2024	TREASURY BILL 0.00% 25-Jan-2024

• TXN ID (Transaction ID): unique transaction ID within the platform.

• Date: date when the transaction was recorded in the system.

• Source: origin of the transaction data (e.g., std_file for standard imported file).

• Date (Trade): actual trade date when the transaction was executed.

• Date (Value): value date when the transaction becomes effective in financial terms.

• Description: freeform description of the transaction (typically includes action and instrument).

• TXN TYPE (Transaction type): transaction type (e.g., Buy, Sell, Coupon, Deposit).

• CCY STL: settlement currency used in the transaction.

• Cash Consideration: monetary amount of the transaction (net cash inflow/outflow).

• Instrument: name of the financial instrument involved in the transaction.

• ISIN: international identifier for the security (International Securities Identification Number).

• Position (Adjusted): net change in instrument quantity after transaction adjustment.

• Account (Cash): cash account associated with the transaction's payment or settlement.

• Portfolio: unique portfolio identifier that the transaction is associated with.

• Status (Reversed): flag indicating whether the transaction has been reversed.

• Status (Cancelled): flag indicating whether the transaction has been cancelled.

• Reference Transaction ID: ID of a related or referenced transaction.

• Allocation (PL): categorization of the transaction for performance or reporting purposes.

• Linked Instrument: related instrument (if transaction is part of a structured deal or derivative).

• Notes: user-defined comments or notes about the transaction.

Cookbook

CRUD

Operations within platform.

Use Cases

What for it's used.

F.A.Q.

Frequently asked questions.

API documentation

Link to API documentation.