> For the complete documentation index, see [llms.txt](https://docs.xyb.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xyb.co/xyb-platform-1/xyb-ledger/getting-started/quickstart/xyb-ledger-terminology.md).

# XYB Ledger Terminology

### Introduction <a href="#introduction" id="introduction"></a>

To get the most out of XYB ledger and drive the best results, we recommend you first familiarise yourself with some standard terms and concepts. With multiple stakeholders with different knowledge levels involved in a financial systems integration, it’s important everyone is aware of key concepts to define and measure success.

### Industry standard terms <a href="#industry-standard-terms" id="industry-standard-terms"></a>

Below are some banking terms to familiarise or refresh your memory.

<table data-header-hidden><thead><tr><th width="225"></th><th></th></tr></thead><tbody><tr><td><strong>Term/Concept</strong></td><td><strong>Definition</strong></td></tr><tr><td><strong>Instruction</strong></td><td>A command submitted to the ledger to initiate specific actions, such as recording <strong>postings</strong> or modifying <strong>movements</strong>. <strong>Instructions</strong> act as the starting point for any operation that changes account balances.</td></tr><tr><td><strong>Movement</strong> </td><td>A <strong>movement</strong> represents the transfer of value between accounts in a ledger, defining how funds shift within the system. It is an intermediate step between an <strong>instruction</strong> (high-level request) and <strong>postings</strong> (detailed accounting records). </td></tr><tr><td><strong>Posting</strong></td><td>A detailed accounting record of a <strong>movement</strong>, ensuring compliance with double-entry accounting. Each <strong>posting</strong> reflects a debit or credit entry that maintains the ledger's balance.</td></tr><tr><td><strong>Group Account</strong></td><td>A consolidated account structure that aggregates the balances and transactions of multiple related accounts, typically assigned for one banking customer.</td></tr><tr><td><strong>Chart Account</strong></td><td>An organized list of all accounts used by an institution, categorizing assets, liabilities, income, and expenses to systematically record and track financial transactions.</td></tr></tbody></table>

### XYB Terms <a href="#xyb-terms" id="xyb-terms"></a>

Familiarise yourself with the terminology used within the XYB system for meaningful integrations.

<table data-header-hidden><thead><tr><th width="228"></th><th></th></tr></thead><tbody><tr><td><strong>Term/Concept</strong></td><td><strong>Definition</strong></td></tr><tr><td><strong>Account</strong></td><td>A central element in the ledger representing either a chart or group account. They do not directly hold balances but serve as containers for wallets.</td></tr><tr><td><strong>Wallet</strong></td><td>A collection of funds within an account. Each wallet is independently addressable and has specific properties, including a currency, accounting type (e.g., liability, asset), and associated balances (committed, reserved debit, reserved credit).</td></tr><tr><td><strong>Rule</strong></td><td>A configurable logic entity in the ledger that enforces conditions and behaviours for processing instructions, movements, and other operations. Rules validate transactions, enforce business policies, and enable automation to ensure compliance and operational consistency.</td></tr><tr><td><strong>Agent</strong></td><td>An entity, such as a user or an application, that interacts with the ledger by performing operations like creating accounts, initiating instructions, or querying data. Agents are authenticated using public/private key pairs and are assigned roles that define their permissions and access levels within the ledger.</td></tr></tbody></table>

Learn how to [integrate with the XYB Ledger](/xyb-platform-1/xyb-ledger/integrate-with-xyb-ledger/ledger-setup-and-configuration.md).

<br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.xyb.co/xyb-platform-1/xyb-ledger/getting-started/quickstart/xyb-ledger-terminology.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.