# Counterparty

It's other party or entity involved in a transaction.

# 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.

# How to Create a Counterparty Entity

## Prerequisites

We assume you have all prerequisites you may need, including:

1. If needed: the VPN is configured to access the Finmars resources
2. If needed: access to the Virtual Machine to work with the sensitive information
3. Must have: registered in Finmars in the needed region environment (self-registered or registered by Finmars)
4. Must have: having permissions set to allow continue with the Action in the Guide

## Creation of Counterparty Entity

1. <span style="color: rgb(170, 170, 170); background-color: rgb(34, 34, 34);">Open the</span> ****“Data”**** <span style="color: rgb(170, 170, 170); background-color: rgb(34, 34, 34);">section in the left-hand side menu. Select the</span> ****“Counterparties”**** <span style="color: rgb(170, 170, 170); background-color: rgb(34, 34, 34); white-space: pre-wrap;">entity from the list under </span>****Data****<span style="color: rgb(170, 170, 170); background-color: rgb(34, 34, 34);">.</span>  
    [![Снимок экрана 2025-05-06 040557.png](https://docs.finmars.com/uploads/images/gallery/2025-05/scaled-1680-/snimok-ekrana-2025-05-06-040557.png)](https://docs.finmars.com/uploads/images/gallery/2025-05/scaled-1680-/snimok-ekrana-2025-05-06-040557.png)
2. ****Click the “+ Add” button****<span style="color: rgb(170, 170, 170); background-color: rgb(34, 34, 34); white-space: pre-wrap;"> located in the top-left corner of the portfolio list view.</span>  
    [![Снимок экрана 2025-05-06 040603.png](https://docs.finmars.com/uploads/images/gallery/2025-05/scaled-1680-/snimok-ekrana-2025-05-06-040603.png)](https://docs.finmars.com/uploads/images/gallery/2025-05/scaled-1680-/snimok-ekrana-2025-05-06-040603.png)
3. <span style="color: rgb(170, 170, 170); background-color: rgb(34, 34, 34); white-space: pre-wrap;">This action opens the </span>****Add****<span style="color: rgb(170, 170, 170); background-color: rgb(34, 34, 34); white-space: pre-wrap;"> </span>****Counterparty**** <span style="color: rgb(170, 170, 170); background-color: rgb(34, 34, 34);">form.</span>  
    [![Снимок экрана 2025-05-06 040613.png](https://docs.finmars.com/uploads/images/gallery/2025-05/scaled-1680-/snimok-ekrana-2025-05-06-040613.png)](https://docs.finmars.com/uploads/images/gallery/2025-05/scaled-1680-/snimok-ekrana-2025-05-06-040613.png)
4. ****Fill in the required fields in the creation panel:****
5. 1. ****Counterparty****<span style="white-space: pre-wrap;"> – full name or identifier for the counterparty (required). This can be a bank, broker, client, or any financial entity you deal with.</span>
    2. ****Group****<span style="white-space: pre-wrap;"> </span>**–** used to organize counterparties into categories such as “Banks,” “Funds,” “Clients,” etc.
    3. ****Notes****<span style="white-space: pre-wrap;"> </span>**–**<span style="white-space: pre-wrap;"> any additional internal comments or metadata for the counterparty.</span>  
        [![copy 3.png](https://docs.finmars.com/uploads/images/gallery/2025-05/scaled-1680-/copy-3.png)](https://docs.finmars.com/uploads/images/gallery/2025-05/scaled-1680-/copy-3.png)
6. <span style="color: rgb(170, 170, 170); background-color: rgb(34, 34, 34);">Click</span> ****“Create and Exit”****<span style="color: rgb(170, 170, 170); background-color: rgb(34, 34, 34); white-space: pre-wrap;"> to save the portfolio and return to the list view. Alternatively, use </span>****“Create”****<span style="color: rgb(170, 170, 170); background-color: rgb(34, 34, 34); white-space: pre-wrap;"> to save and continue editing.</span>