Accounts

Create a new ledger account

Create a ledger account linked to an external liquidity provider.

Supported Providers:

CIRCLE_MINT: Circle Mint USDC accounts for institutional settlement
OPENFX: OpenFX workspace ledger accounts

Ledger accounts are virtual accounts managed by the provider. They enable fast settlement without on-chain transactions.

Ownership: Use tenant_id OR counterparty_id to link the account. Omit both for a workspace-level ledger account.

post/v1/accounts/ledgers

Request

Base URL
https://api.tesser.xyz
Auth
HTTP bearer
TypeScript
https://skmtc.dev/tesser/apis/tesser-api/docs/v1/accounts/ledgers/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

tenant_idstring uuid nullable

Tenant ID (mutually exclusive with counterparty_id). Links this ledger account to a specific tenant.

counterparty_idstring uuid nullable

Counterparty ID (mutually exclusive with tenant_id). Links this ledger account to a specific counterparty.

namestring required

Human-readable name for the ledger account

provider'CIRCLE_MINT' | 'OPENFX' required

Liquidity provider that manages this ledger account.

Example request

{
  "tenant_id": "550e8400-e29b-41d4-a716-446655440002",
  "counterparty_id": "660e8400-e29b-41d4-a716-446655440003",
  "name": "Circle USDC Account",
  "provider": "CIRCLE_MINT"
}

Response

Ledger account created successfully

Example response

{
  "data": {
    "assets": [
      {
        "currency": "USDC",
        "available_balance": "1"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.