> 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-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-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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.