# Idem

## Docs

- [Idem: Open-Source Double-Entry Ledger for Cross-Border Stablecoin Payments](https://docs.idem.finance/introduction.md): Idem is an open-source, event-sourced double-entry ledger for cross-border stablecoin payment institutions. Fiat and on-chain entries in one model, with a first-class agentic execution layer.
- [Authenticate with the Idem Using API Keys](https://docs.idem.finance/authentication.md): Learn how to create API keys, assign scopes, and include your key in every Idem Ledger API request. Covers key rotation and scope best practices.
- [Quickstart: Post Your First Idem Ledger Transaction](https://docs.idem.finance/quickstart.md): Learn how to authenticate, create accounts, and post your first balanced double-entry transaction with the Idem Ledger API in under 10 minutes.
- [Double-Entry Bookkeeping and Balanced Transactions](https://docs.idem.finance/concepts/double-entry.md): Learn how the Idem Ledger enforces double-entry bookkeeping. Every transaction must have balanced debits and credits per currency across all journal lines.
- [Idem Ledger Accounts: Types, Currencies, and Balances](https://docs.idem.finance/concepts/accounts.md): Understand the Idem Ledger account model. Accounts hold balances in a single currency and can be ASSET, LIABILITY, EQUITY, REVENUE, or EXPENSE type.
- [Settlement Lifecycle: Tracking On-Chain Stablecoin Transfers](https://docs.idem.finance/concepts/settlements.md): Learn how Idem Ledger settlement expectations watch for incoming on-chain stablecoin transfers and automatically match them to your accounts.
- [Idem API Key Scopes and Least-Privilege Access Control](https://docs.idem.finance/concepts/scopes.md): Idem Ledger API keys carry scopes that limit what each key can do. Learn all available scopes and how to issue least-privilege keys for each integration.
- [Post a Double-Entry Transaction with the Idem Ledger API](https://docs.idem.finance/guides/post-transaction.md): Step-by-step guide to posting a balanced double-entry transaction using the Idem Ledger API. Covers fiat entries, on-chain entries, metadata, and idempotency.
- [Register and Track On-Chain Settlement Expectations](https://docs.idem.finance/guides/settlements.md): Learn how to register settlement expectations in Idem Ledger, watch for incoming stablecoin transfers, and handle PENDING, SETTLED, UNMATCHED, and CANCELLED states.
- [Trigger Batch Reconciliation for Unmatched Transactions](https://docs.idem.finance/guides/reconciliation.md): Learn when and how to use the Idem Ledger batch reconciliation endpoint to re-run matching for transactions that were not reconciled on initial commit.
- [Export Audit Logs for Compliance and Reporting](https://docs.idem.finance/guides/compliance.md): Use the Idem Ledger compliance export endpoint to stream NDJSON audit records for any time window. Filter by HUMAN or AGENT activity for targeted reporting.
- [Configure Webhooks to Receive Real-Time Event Notifications](https://docs.idem.finance/guides/webhooks.md): Set up a webhook endpoint to receive real-time notifications from the Idem Ledger API. Covers registration, secret verification, and updating your URL.
- [Configure On-Chain Providers (Alchemy, QuickNode, Tron)](https://docs.idem.finance/guides/chain-providers.md): Configure Alchemy, QuickNode, and Tronscan so a self-hosted Idem instance can detect on-chain stablecoin transfers and match them to your settlements.
- [Configure Agent Policy Rules to Control Automated Transactions](https://docs.idem.finance/guides/policy-rules.md): Learn how to create and manage policy rules that control what agent-originated transactions are permitted in the Idem Ledger API.
- [Connect AI Agents to Idem via the MCP Server](https://docs.idem.finance/guides/mcp-tools.md): Connect Claude Desktop, Claude Code, or any MCP-compatible agent to Idem's ledger tools — post transactions, query balances, reconcile, and roll back workflows under policy-guarded, HMAC-signed audit.
- [List All Ledger Accounts for Your Tenant — Overview](https://docs.idem.finance/api-reference/accounts/list-accounts.md): GET /api/v1/accounts — returns all accounts for your tenant. Requires ACCOUNTS_READ scope. Each account includes its ID, name, currency, and type.
- [Create a Ledger Account With Currency, Type, and Name](https://docs.idem.finance/api-reference/accounts/create-account.md): POST /api/v1/accounts — creates a new ledger account for your tenant. Requires ACCOUNTS_WRITE scope. Specify name, currency, and account type.
- [Get Account Balance — Current or Point in Time Query](https://docs.idem.finance/api-reference/accounts/get-balance.md): GET /api/v1/accounts/{accountId}/balance — returns the current or historical balance for an account. Pass asOf for point-in-time queries.
- [Retrieve All Paginated Journal Entries for an Account](https://docs.idem.finance/api-reference/accounts/list-entries.md): GET /api/v1/accounts/{id}/entries — paginated reverse-chronological journal entries. Filter by date range and paginate with an opaque cursor.
- [Generate an Account Statement for a Custom Date Range](https://docs.idem.finance/api-reference/accounts/get-statement.md): GET /api/v1/accounts/{id}/statement — period statement with opening balance, movements, and closing balance. Both from and to are required.
- [POST /api/v1/transactions — Post a Balanced Transaction](https://docs.idem.finance/api-reference/transactions/post-transaction.md): POST /api/v1/transactions — post a balanced double-entry transaction. Requires Idempotency-Key header. Debits must equal credits per currency.
- [List Settlements with Filtering and Pagination](https://docs.idem.finance/api-reference/settlements/list-settlements.md): GET /api/v1/settlements — lists settlements filtered by status and date range with cursor pagination. Statuses: PENDING, SETTLED, UNMATCHED, CANCELLED.
- [Register a Settlement Expectation for Wallet Watching](https://docs.idem.finance/api-reference/settlements/register-settlement.md): POST /api/v1/settlements — register a settlement expectation. Idem watches the wallet for an on-chain stablecoin transfer and auto-reconciles on match.
- [Retrieve Settlement Details and Current Status by ID](https://docs.idem.finance/api-reference/settlements/get-settlement.md): GET /api/v1/settlements/{id} — retrieves a single settlement by UUID. Returns current status (PENDING/SETTLED/UNMATCHED/CANCELLED) and matching details.
- [Cancel a Pending Settlement and Stop Transfer Watching](https://docs.idem.finance/api-reference/settlements/cancel-settlement.md): DELETE /api/v1/settlements/{id} — cancels a PENDING settlement expectation. Returns 409 if already terminal (SETTLED or UNMATCHED). Cannot be undone.
- [Trigger Batch Reconciliation for Multiple Transactions](https://docs.idem.finance/api-reference/reconciliation/batch-reconcile.md): POST /api/v1/reconciliation/batch — re-runs reconciliation for up to 100 transaction IDs. Useful for transactions not matched on initial commit.
- [Export Tenant Compliance Audit Log as NDJSON Stream](https://docs.idem.finance/api-reference/compliance/audit-export.md): GET /api/v1/compliance/audit-export — streams audit records as NDJSON. Filter by HUMAN, AGENT, or ALL activity. Both from and to are required.
- [List All API Keys and Their Scopes for Your Tenant](https://docs.idem.finance/api-reference/admin/list-api-keys.md): GET /api/v1/api-keys — lists all API keys for your tenant. Raw key values are never returned. Requires ADMIN scope to protect key management.
- [Create a Scoped API Key with Least-Privilege Permissions](https://docs.idem.finance/api-reference/admin/create-api-key.md): POST /api/v1/api-keys — creates a new API key with specified scopes. The raw key is shown only once in the response. Store it immediately and securely.
- [Revoke an API Key and Immediately Invalidate Access](https://docs.idem.finance/api-reference/admin/revoke-api-key.md): DELETE /api/v1/api-keys/{keyId} — immediately revokes an API key. All in-flight requests using the key will begin failing with 401 after revocation.
- [List All Agent Policy Rules Configured for Your Tenant](https://docs.idem.finance/api-reference/admin/list-policy-rules.md): GET /api/v1/admin/policy-rules — returns all policy rules for your tenant. Policy rules control what agent-originated transactions are permitted.
- [Create an Agent Policy Rule to Restrict Transactions](https://docs.idem.finance/api-reference/admin/create-policy-rule.md): POST /api/v1/admin/policy-rules — create a policy rule to restrict agent-originated transactions. Scope by key prefix, token, chain, or amount limit.
- [Delete a Policy Rule and Revoke Agent Authorization](https://docs.idem.finance/api-reference/admin/delete-policy-rule.md): DELETE /api/v1/admin/policy-rules/{ruleId} — permanently deletes a policy rule. Agents relying on this rule may have transactions rejected immediately.
- [Retrieve the Current Webhook Configuration for Your Tenant](https://docs.idem.finance/api-reference/admin/get-webhook.md): GET /api/v1/tenant/webhook — retrieves the current webhook URL for your tenant. The webhook secret is always masked in this response for security.
- [Register or Update Your Tenant Webhook URL and Secret](https://docs.idem.finance/api-reference/admin/update-webhook.md): PUT /api/v1/tenant/webhook — registers or updates the webhook URL. A new secret is issued and shown once. Requires WEBHOOK_MANAGE scope.