# Counterparty

#### **Table of Contents**

- [Description](#bkmrk-description)
- [Examples](#bkmrk-examples)
- [Cookbook](#bkmrk-cookbook)
- [F.A.Q.](#bkmrk-api-documentation)
- [API Documentation](#bkmrk-api-documentation)

#### **Description**

##### *Financial meaning*

A **counterparty** is any party — individual or organization — that participates in a financial transaction from the opposite side. In capital markets and investment platforms, counterparties include brokers, banks, issuers, custodians, and clients.

##### *Platform abstraction*

In the Finmars platform, **Counterparty** is a master data entity used to associate financial [transactions](https://docs.finmars.com/books/entities/page/transactions "Transactions"), [portfolios](https://docs.finmars.com/books/entities/page/portfolio "Portfolio"), and [registers ](https://docs.finmars.com/books/entities/page/register "Register")with external trading parties.

**Counterparty also is used in:**

- As a reference for identifying the external trading party involved in a [transaction](https://docs.finmars.com/books/entities/page/transactions "Transactions").
- position settlement, linked with [portfolio ](https://docs.finmars.com/books/entities/page/portfolio "Portfolio")to reflect obligations per counterparty.
- cash flow tracking, where it is associated with [account](https://docs.finmars.com/books/entities/page/accounts "Accounts") to record inflows and outflows per counterparty;

#### **Examples**

<table border="1" id="bkmrk-user-code%C2%A0-group%C2%A0-sh" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 16.6891%;"></col><col style="width: 16.6891%;"></col><col style="width: 16.6891%;"></col><col style="width: 16.6891%;"></col><col style="width: 16.6891%;"></col><col style="width: 16.6891%;"></col></colgroup><tbody><tr><td>User code </td><td>Group </td><td>Short name </td><td>Name </td><td>Public name </td><td>Notes </td></tr><tr><td>CH-BND-20394857</td><td>  
</td><td>Am\_test01\_</td><td>Am Test01</td><td>  
</td><td>  
</td></tr></tbody></table>

- `<strong data-end="187" data-start="174">User code</strong>`: unique identifier assigned to the counterparty. Used for internal reference and tracking.
- `Group`: a logical classification that allows grouping counterparties by type, role, or business relationship. Useful for filtering and reporting.
- `<strong data-end="991" data-start="977">Short name</strong>`: abbreviated or condensed label for quick reference.
- `<strong data-end="1097" data-start="1089">Name</strong>`: the full legal or registered name of the counterparty as used internally and in official documentation.
- `<strong data-end="1211" data-start="1196">Public name</strong>`: market-facing or external name of the instrument, often matching how it appears on exchanges or public reports.
- `<strong data-end="2170" data-start="2161">Notes</strong>`: free-text field for comments or special handling notes related to the counterparty.

#### **Cookbook**

##### *CRUD* 

Operations within platform.

##### *Use Cases*

What for it's used.

#### **F.A.Q.**

Frequently asked questions.

#### **API documentation**

Link to API documentation.