2. Soroban TXs

2.1 GET /txs/by-ledger

Query params

• from (i32, optional) – default 0

• to (i32, optional) – default i32::MAX

• limit (i64, optional) – default 100, max 1000

• offset (i64, optional) – default 0

• cursor (hex string, optional) – tx field of last row from previous page; when set, offset is ignored

Example

curl -X GET \
  "$BASE/txs/by-ledger?from=500000&to=500500&limit=100&offset=0" \
  -H "Authorization: $AUTH"

---

2.2 GET /txs/by-contract/{contract_id}

Two behaviors.

2.2.a just contract

curl -X GET \
  "$BASE/txs/by-contract/CAS3J7GYLGXMF6TDJBBYYSE3HQ6BBSMLNUQ34T6TZMYMW2EVH34XOWMA?limit=100&offset=0" \
  -H "Authorization: $AUTH"

2.2.b contract + ledger

curl -X GET \
  "$BASE/txs/by-contract/CAS3J7GYLGXMF6TDJBBYYSE3HQ6BBSMLNUQ34T6TZMYMW2EVH34XOWMA?from=500000&to=500500&limit=100&cursor=af01bc..."" \
  -H "Authorization: $AUTH"

Precedence:

1. if from or to → ledger branch

2. else → base

---

2.3 GET /txs/by-contracts

Query params

• contracts=ID1,ID2,... (required) – comma-separated contract IDs

• limit (i64, optional) – default 100, max 1000

• offset (i64, optional) – default 0

• cursor (hex string, optional) – tx field of last row from previous page; when set, offset is ignored

Example

curl -X GET \
  "$BASE/txs/by-contracts?contracts=CONTRACT1,CONTRACT2&limit=100&offset=0" \
  -H "Authorization: $AUTH"

---

2.4 GET /txs/by-ledger/contracts

Multiple contracts + ledger filter

Query params

• contracts=ID1,ID2,... (required) – comma-separated contract IDs

• from (i32, optional) – default 0

• to (i32, optional) – default i32::MAX

• limit (i64, optional) – default 100, max 1000

• offset (i64, optional) – default 0

• cursor (hex string, optional) – tx field of last row from previous page; when set, offset is ignored

Example

curl -X GET \
  "$BASE/txs/by-ledger/contracts?contracts=CONTRACT1,CONTRACT2&from=500000&to=500500&limit=100&offset=0" \
  -H "Authorization: $AUTH"

---

2.5 GET /txs/by-hash/{tx_hex}

curl -X GET \
  "$BASE/txs/by-hash/af01bc..." \
  -H "Authorization: $AUTH"