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

500

Internal server error.

application/json

get

/v1/txv

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

500

Internal server error.

application/json

get

/v1/fee

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

500

Internal server error.

application/json

get

/v1/confirmed-length

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

500

Internal server error.

application/json

get

/v1/unconfirmed-length

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

400

Missing address.

application/json

500

Internal server error.

application/json

get

/v1/balance/{address}

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

400

Invalid address or invalid confirmed parameter.

application/json

500

Internal server error.

application/json

get

/v1/account/{address}

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}

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}

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

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}

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

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

Responses

200

Payloads returned successfully.

application/json

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

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

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

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

PreviousMain Settlement Bus NextGasless Net (R1)

Last updated 23 hours ago

hashtagNetwork State

hashtagGet current TXV

hashtagGet fee

hashtagGet current transaction fee

hashtagGet confirmed length

hashtagGet confirmed ledger length

hashtagGet unconfirmed length

hashtagGet unconfirmed ledger length

hashtagWallet & Account

hashtagGet balance

hashtagGet wallet balance

hashtagGet account details

hashtagGet account details

hashtagTransactions - Read

hashtagList transaction hashes

hashtagGet transaction hashes by confirmed-length range

hashtagGet transaction by hash

hashtagGet confirmed transaction details

hashtagGet transaction details

hashtagGet transaction details with confirmation metadata

hashtagTransactions - Write

hashtagResolve transaction payloads (bulk)

hashtagGet transaction payloads in bulk

hashtagBroadcast signed transaction

hashtagBroadcast signed transaction

hashtagErrors & Limits

hashtagConfirmed query behavior

hashtagtx-hashes range constraints

hashtagBulk request limits

hashtagBroadcast rate limiting

hashtagSchemas

Network State

Get current TXV

Get fee

Get current transaction fee

Get confirmed length

Get confirmed ledger length

Get unconfirmed length

Get unconfirmed ledger length

Wallet & Account

Get balance

Get wallet balance

Get account details

Get account details

Transactions - Read

List transaction hashes

Get transaction hashes by confirmed-length range

Get transaction by hash

Get confirmed transaction details

Get transaction details

Get transaction details with confirmation metadata

Transactions - Write

Resolve transaction payloads (bulk)

Get transaction payloads in bulk

Broadcast signed transaction

Broadcast signed transaction

Errors & Limits

Confirmed query behavior

`tx-hashes` range constraints

Bulk request limits

Broadcast rate limiting

Schemas