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

DescriptionTransaction 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 thetruth entityfor inportfolio Platformactivity, (incl.capturing diagrams,events excelsuch as purchases, sales, income, redemptions, and other explanatorymovements.

materials

Transaction onalso howis itused works).in:

• valuation, serving as inputs for position lifecycle, pricing, and historical 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

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

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

• PlatformTXN screenshotsID: withunique atransaction 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 (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 recordrelated tableor example.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.