Trancent Docs

Getting Started

Post your first balanced journal entry in a few minutes.

1. Create an account

Sign up at app.trancent.dev. The Builder tier is free — no credit card required. You get 50,000 transactions per month.

2. Create an organization and ledger

From the dashboard, create an organization (e.g. Acme Corp), then create a ledger inside it (e.g. Token Budget). Each ledger is a fully isolated double-entry book with its own chart of accounts.

Note the org ID and ledger ID shown in the dashboard — you’ll need them in API calls.

3. Create an API key

In the dashboard under API Keys, create a key. Copy the secret immediately — it is shown only once.

Base URL: All API calls go to https://api.trancent.dev. Every endpoint below is relative to that base.

API keys have the format:

tk_live_<secret>   # production
tk_test_<secret>   # test mode

All Service API requests must be HMAC-SHA256 signed. See Authentication for the signing algorithm.

4. Post a journal entry

A journal entry is the atomic unit of a ledger. Every entry must have at least two lines whose functionalAmount values sum to zero (one debit, one credit).

Amounts are integers in the smallest currency unit (e.g. cents for USD). Never use floating point.

POST https://api.trancent.dev/v1/organizations/:orgId/ledgers/:ledgerId/journal-entries
Authorization: Bearer tk_live_<secret>
X-Timestamp: <unix-seconds>
X-Signature: <hmac-sha256>
Content-Type: application/json

{
  "externalId": "charge_abc123",
  "description": "Token grant — monthly plan",
  "lines": [
    {
      "glAccountCode": "assets.token-pool",
      "description": "Token pool increase",
      "transactionAmount": 10000,
      "transactionCurrency": "USD",
      "functionalAmount": 10000,
      "functionalCurrency": "USD"
    },
    {
      "glAccountCode": "revenue.token-sales",
      "description": "Token sale revenue",
      "transactionAmount": -10000,
      "transactionCurrency": "USD",
      "functionalAmount": -10000,
      "functionalCurrency": "USD"
    }
  ]
}

Double-entry rule: The sum of all functionalAmount values must equal zero. The request is rejected with 400 if the entry does not balance.

5. Query a balance

GET https://api.trancent.dev/v1/organizations/:orgId/ledgers/:ledgerId/balances?account=assets.token-pool
{
  "glAccountCode": "assets.token-pool",
  "balance": 10000,
  "currency": "USD",
  "entryCount": 1
}

Next steps