RPC API v1

Reference documentation for the public v1 RPC endpoints on Trac Network mainnet.

Use these endpoints to read ledger state and submit transactions.

Network State

Get current TXV

get

Returns the current transaction validity hash (txv) as hex.

Responses

200

TXV returned successfully.

application/json

txvstringRequired

500

Internal server error.

application/json

get/v1/txv

HTTPcURLJavaScriptPython

GET /v1/txv HTTP/1.1
Host: tracapi.trac.network
Accept: */*

{
  "txv": "54f57c8d3c4fb3e653201aa9a040e3f673e80c939a95f0a477b18fe51dbfd186"
}

Get fee

Returns the fee used for transaction submission.

Get current transaction fee

get

Responses

200

Fee returned successfully.

application/json

feestringRequired

500

Internal server error.

application/json

get/v1/fee

HTTPcURLJavaScriptPython

GET /v1/fee HTTP/1.1
Host: tracapi.trac.network
Accept: */*

{
  "fee": "30000000000000000"
}

Get confirmed length

Returns the current confirmed ledger length.

Get confirmed ledger length

get

Responses

200

Confirmed length returned successfully.

application/json

confirmed_lengthintegerRequired

500

Internal server error.

application/json

get/v1/confirmed-length

HTTPcURLJavaScriptPython

GET /v1/confirmed-length HTTP/1.1
Host: tracapi.trac.network
Accept: */*

{
  "confirmed_length": 63
}

Get unconfirmed length

Returns the current unconfirmed ledger length.

Get unconfirmed ledger length

get

Responses

200

Unconfirmed length returned successfully.

application/json

unconfirmed_lengthintegerRequired

500

Internal server error.

application/json

get/v1/unconfirmed-length

HTTPcURLJavaScriptPython

GET /v1/unconfirmed-length HTTP/1.1
Host: tracapi.trac.network
Accept: */*

{
  "unconfirmed_length": 63
}

Wallet & Account

Get balance

Returns the current balance for an address.

Get wallet balance

get

Returns balance for the specified wallet address.

confirmed query behavior:

• missing: defaults to confirmed view

• true: confirmed view

• false: unconfirmed view

• any other value: falls back to unconfirmed view

Path parameters

addressstring · min: 1Required

Wallet/account address.

Query parameters

confirmedstringOptional

Balance endpoint behavior:

• true for confirmed view
• false for unconfirmed view
• omitted => confirmed view
• any other value => treated as unconfirmed view

Default: true

Responses

200

Balance returned successfully.

application/json

addressstringRequired

balancestringRequired

400

Missing address.

application/json

500

Internal server error.

application/json

get/v1/balance/{address}

HTTPcURLJavaScriptPython

GET /v1/balance/{address} HTTP/1.1
Host: tracapi.trac.network
Accept: */*

{
  "address": "trac1hyg3mv57fph35qev4xsa74n7rey2lkg9puq9yzq6aq84r023ldcqyk889z",
  "balance": "782500000000000000"
}

Get account details

Returns account details for an address.

Get account details

get

Returns account details (roles, keys, balances and license).

confirmed must be exactly true or false.

Path parameters

addressstring · min: 1Required

Wallet/account address.

Query parameters

confirmedstring · enumOptional

Must be exactly true or false.

Default: truePossible values:

Responses

200

Account details returned successfully.

application/json

addressstringRequired

writingKeystringRequired

64-character hex writing key. Can be all zeros when no writer key is assigned.

Example: 0000000000000000000000000000000000000000000000000000000000000000Pattern: ^[A-Fa-f0-9]{64}$

isWhitelistedbooleanRequired

isValidatorbooleanRequired

isIndexerbooleanRequired

licensestring · nullableRequired

balancestringRequired

stakedBalancestringRequired

400

Invalid address or invalid confirmed parameter.

application/json

500

Internal server error.

application/json

get/v1/account/{address}

HTTPcURLJavaScriptPython

GET /v1/account/{address} HTTP/1.1
Host: tracapi.trac.network
Accept: */*

{
  "address": "trac1xljl28ugeskpcswxdxlsx7f9n7jtt5pxusf6qmq08na0j30f6n9smus3rh",
  "writingKey": "0000000000000000000000000000000000000000000000000000000000000000",
  "isWhitelisted": false,
  "isValidator": false,
  "isIndexer": false,
  "license": null,
  "balance": "49630000000000000000",
  "stakedBalance": "0"
}

Transactions - Read

List transaction hashes

Returns transaction hashes for a confirmed-length range.

The start length must be less than or equal to the end length. The range must fall within the current confirmed length.

Get transaction hashes by confirmed-length range

get

Returns transaction hashes in inclusive range.

Rules:

• both params must be integers

• both params must be non-negative

• end must be greater than or equal to start

• max difference is 1000

Path parameters

start_confirmed_lengthintegerRequired

Start of confirmed-length range (inclusive).

end_confirmed_lengthintegerRequired

End of confirmed-length range (inclusive).

Responses

200

Hashes returned successfully.

application/json

400

Invalid range parameters.

application/json

500

Internal server error.

application/json

get/v1/tx-hashes/{start_confirmed_length}/{end_confirmed_length}

HTTPcURLJavaScriptPython

GET /v1/tx-hashes/{start_confirmed_length}/{end_confirmed_length} HTTP/1.1
Host: tracapi.trac.network
Accept: */*

{
  "hashes": [
    {
      "hash": "6641baabac7e4815815876f90a7529f230a3d996209561803c1e05789b06c300",
      "confirmed_length": 11
    },
    {
      "hash": "2acc0ca12abad63222e06193820cf1ee8599aeb7d720d57ffad0311a0cd27a4a",
      "confirmed_length": 15
    }
  ]
}

Get transaction by hash

Returns the transaction payload by hash.

If the endpoint supports a confirmed query parameter, use it to select the confirmed view. Use the parameter details shown in the operation for default behavior.

Get confirmed transaction details

get

Returns normalized details for confirmed transaction hash.

Current handler behavior:

• if not found, returns 404 with { "txDetails": null }

• hash format is not strictly validated at handler layer

Path parameters

transactionHashstring · min: 1Required

Transaction hash.

Responses

200

Transaction details returned successfully.

application/json

404

Transaction not found.

application/json

500

Internal server error.

application/json

get/v1/tx/{transactionHash}

HTTPcURLJavaScriptPython

GET /v1/tx/{transactionHash} HTTP/1.1
Host: tracapi.trac.network
Accept: */*

{
  "txDetails": {
    "type": 13,
    "address": "trac1xljl28ugeskpcswxdxlsx7f9n7jtt5pxusf6qmq08na0j30f6n9smus3rh",
    "tro": {
      "tx": "0b4d1c1dac48af13212f616601d7399457476a0b644850875b7f4b79df6ff89c",
      "txv": "54f57c8d3c4fb3e653201aa9a040e3f673e80c939a95f0a477b18fe51dbfd186",
      "to": "trac1fxmkmd4p4sn7aqsya7tuuc9dzhs4zp8pnwfz8msnyfvf5n6g0lqqg6uz0a",
      "am": "1000000000000000000",
      "in": "40bb3aca8b4fda5afa8bc1558843ff81727d9ccc84953050d3359c0e5733dc69",
      "is": "2f3639d487bc502961a80240f9ab4adbc671eb93ba08286383a615a4cfa95826b57b4b339502eae3de5a6b7bfd080cd0d68ffa2c042453a308ca9afc5e8c100b",
      "va": "trac1hyg3mv57fph35qev4xsa74n7rey2lkg9puq9yzq6aq84r023ldcqyk889z",
      "vn": "b68a83b508ffa35b1984c1835905b2ba8ab230a202cf62f3d58e109f77f97804",
      "vs": "ab3b4049a552b0b1a1a455e4b1f33c367a86f0312ba5c08050fdac1446a927236b43d79f4d16c260b5dbe96b4b1355dddc9c16174b9c2ed813368e33acf8600f"
    }
  }
}

Get transaction details

Returns the transaction plus decoded and enriched details.

txDetails.tro example (full field set)

Examples for txDetails.tro should include all fields below. This avoids “missing field” ambiguity in client code.

{
  "tx": "<transaction-hash>",
  "txv": "<transaction-vailidity>",
  "to": "<to-address>",
  "am": "<amount>",
  "in": "<requester-nonce>",
  "is": "<requester-signature>",
  "va": "<validator-address>",
  "vn": "<validator-nonce>",
  "vs": "<validator-signature>"
}

Get transaction details with confirmation metadata

get

Returns transaction details with confirmed_length and fee.

confirmed must be exactly true or false.

Path parameters

transactionHashstringRequired

Transaction hash (64-char hex string).

Pattern: ^[A-Fa-f0-9]{64}$

Query parameters

confirmedstring · enumOptional

Must be exactly true or false.

Default: truePossible values:

Responses

200

Transaction details returned successfully.

application/json

confirmed_lengthintegerRequired

Confirmed ledger length (0 when transaction is not yet confirmed).

feestringRequired

400

Invalid transaction hash or invalid confirmed parameter.

application/json

404

Transaction not found.

application/json

500

Internal server error.

application/json

get/v1/tx/details/{transactionHash}

HTTPcURLJavaScriptPython

GET /v1/tx/details/{transactionHash} HTTP/1.1
Host: tracapi.trac.network
Accept: */*

{
  "txDetails": {
    "type": 13,
    "address": "trac1xljl28ugeskpcswxdxlsx7f9n7jtt5pxusf6qmq08na0j30f6n9smus3rh",
    "tro": {
      "tx": "0b4d1c1dac48af13212f616601d7399457476a0b644850875b7f4b79df6ff89c",
      "txv": "54f57c8d3c4fb3e653201aa9a040e3f673e80c939a95f0a477b18fe51dbfd186",
      "to": "trac1fxmkmd4p4sn7aqsya7tuuc9dzhs4zp8pnwfz8msnyfvf5n6g0lqqg6uz0a",
      "am": "1000000000000000000",
      "in": "40bb3aca8b4fda5afa8bc1558843ff81727d9ccc84953050d3359c0e5733dc69",
      "is": "2f3639d487bc502961a80240f9ab4adbc671eb93ba08286383a615a4cfa95826b57b4b339502eae3de5a6b7bfd080cd0d68ffa2c042453a308ca9afc5e8c100b",
      "va": "trac1hyg3mv57fph35qev4xsa74n7rey2lkg9puq9yzq6aq84r023ldcqyk889z",
      "vn": "b68a83b508ffa35b1984c1835905b2ba8ab230a202cf62f3d58e109f77f97804",
      "vs": "ab3b4049a552b0b1a1a455e4b1f33c367a86f0312ba5c08050fdac1446a927236b43d79f4d16c260b5dbe96b4b1355dddc9c16174b9c2ed813368e33acf8600f"
    }
  },
  "confirmed_length": 82,
  "fee": "30000000000000000"
}

Transactions - Write

Resolve transaction payloads (bulk)

Fetches multiple transaction payloads in one request.

This endpoint enforces request and response size limits. Split requests into smaller batches when you hit limits.

Get transaction payloads in bulk

post

Returns payloads for provided transaction hash list.

Limits:

• max 1500 hashes per request

• request body limit: 1_000_000 bytes

• response body limit: 2_000_000 bytes

Body

application/json

hashesstring[] · min: 1 · max: 1500Required

Responses

200

Payloads returned successfully.

application/json

missingstring[]Required

400

Invalid request body.

application/json

413

Request/response size limits exceeded.

application/json

500

Internal server error.

application/json

post/v1/tx-payloads-bulk

HTTPcURLJavaScriptPython

POST /v1/tx-payloads-bulk HTTP/1.1
Host: tracapi.trac.network
Content-Type: application/json
Accept: */*
Content-Length: 86

{
  "hashes": [
    "d9ecb7020563f99cc171a1fa3d57e05ed001fac5ca58789f7a21cd1afdceb05b",
    "test"
  ]
}

{
  "results": [
    {
      "hash": "d9ecb7020563f99cc171a1fa3d57e05ed001fac5ca58789f7a21cd1afdceb05b",
      "payload": {
        "type": 5,
        "address": "trac1j79k35xyz2v8zzw59xdlyptj56yd47zjdtmyq3mcd073t0c5kjjqfrr05t",
        "tro": {
          "tx": "d9ecb7020563f99cc171a1fa3d57e05ed001fac5ca58789f7a21cd1afdceb05b",
          "txv": "f8f8f5ae1a45aee14ea196e3ed97bbb2fb52708cb775de24c4b2b9af86a70624",
          "to": "trac1fxmkmd4p4sn7aqsya7tuuc9dzhs4zp8pnwfz8msnyfvf5n6g0lqqg6uz0a",
          "am": "1000000000000000000",
          "in": "0936963ac9e56707b27e0d215cdb6deeb4f654f26e1516373f49c417c3b57df8",
          "is": "4e4b056f083a49de45a4ca5d0f8ddf5b813b5ecceaaea969a191ff491f5b68a3faa5f9d5dbdf907550b1e50da1293c64b6604a77caeba7fe448ff82efb66070c",
          "va": "trac1hyg3mv57fph35qev4xsa74n7rey2lkg9puq9yzq6aq84r023ldcqyk889z",
          "vn": "8a1eb8d0923e662bb6f2082931b3b7132a94bff3e5beb68a9c72c37cd6e82d14",
          "vs": "9d141b9e891fc0d837db79ab36417c4dc530c80556896111ae5611af4f54c2259b1a37c1815efa2c59381db0c537c132b031253b846244c492cd8c3052b96708"
        }
      }
    }
  ],
  "missing": [
    "test"
  ]
}

Broadcast signed transaction

Broadcasts a signed transaction payload to the network.

This endpoint may return 429 Too Many Requests when rate limited. Retry with backoff.

Broadcast signed transaction

post

Broadcasts a signed transaction payload.

Request requirements:

• body must be valid JSON

• body must contain payload

• payload must be valid Base64 string

Body

application/json

payloadstringRequired

Base64-encoded signed transaction.

Responses

200

Transaction accepted and broadcasted.

application/json

400

Invalid request payload.

application/json

429

Broadcast retry limit reached.

application/json

500

Internal server error.

application/json

post/v1/broadcast-transaction

HTTPcURLJavaScriptPython

POST /v1/broadcast-transaction HTTP/1.1
Host: tracapi.trac.network
Content-Type: application/json
Accept: */*
Content-Length: 40

{
  "payload": "BASE64_ENCODED_TRANSACTION"
}

{
  "result": {
    "message": "Transaction broadcasted successfully.",
    "signedLength": 123,
    "unsignedLength": 122,
    "tx": "6641baabac7e4815815876f90a7529f230a3d996209561803c1e05789b06c300"
  }
}

Errors & Limits

Confirmed query behavior

Some read endpoints accept a confirmed query parameter. It selects a confirmed view versus an unconfirmed view. Treat it as a consistency knob for reads.

tx-hashes range constraints

Ranges are constrained by confirmed length. Invalid ranges should be treated as client errors. Request smaller windows if you hit server limits.

Bulk request limits

/v1/tx-payloads-bulk is designed for batching. Keep batches small and bounded.

Broadcast rate limiting

/v1/broadcast-transaction can respond with 429. Back off and retry.

Schemas