Transactions

List transactions (ledger)

get

https://sandbox.sverse.iohttps://open.sverse.io

/v1/transactions

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

chainKeystringOptional

walletIdstringOptional

projectIdstringOptional

typestring · enumOptionalPossible values:

statusstring · enumOptionalPossible values:

cursorstringOptional

limitinteger · min: 1 · max: 200OptionalDefault: 50

Responses

200

Transactions list

application/json

get

/v1/transactions

HTTPcURLJavaScriptPython

GET /v1/transactions HTTP/1.1
Host: sandbox.sverse.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Transactions list

{
  "items": [
    {
      "id": "tx_01HXYZ...",
      "projectId": "text",
      "type": "transfer",
      "status": "pending",
      "createdAt": "2026-01-19T11:19:09.886Z",
      "chainKey": "eth-mainnet",
      "onchainTxHash": "text",
      "confirmations": 1,
      "explorerUrl": "text",
      "fromWalletId": "text",
      "toWalletId": "text",
      "currencyCode": "text",
      "amount": "text",
      "reference": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  ],
  "page": {
    "nextCursor": "text"
  }
}

Transfer tokens/currency between wallets (chain-aware)

post

https://sandbox.sverse.iohttps://open.sverse.io

/v1/transactions/transfer

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

chainKeystringRequired

Which chain to execute/settle this transfer on.

Example: ton-mainnet

projectIdstring | nullableOptional

fromWalletIdstringRequired

toWalletIdstringRequired

currencyCodestringRequiredExample: GOLD

amountstringRequiredExample: 10.00

idempotencyKeystring | nullableOptional

memostring | nullableOptional

Responses

201

Transfer initiated

application/json

post

/v1/transactions/transfer

HTTPcURLJavaScriptPython

POST /v1/transactions/transfer HTTP/1.1
Host: sandbox.sverse.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 164

{
  "chainKey": "ton-mainnet",
  "projectId": "text",
  "fromWalletId": "text",
  "toWalletId": "text",
  "currencyCode": "GOLD",
  "amount": "10.00",
  "idempotencyKey": "text",
  "memo": "text"
}

201

Transfer initiated

{
  "id": "tx_01HXYZ...",
  "projectId": "text",
  "type": "transfer",
  "status": "pending",
  "createdAt": "2026-01-19T11:19:09.886Z",
  "chainKey": "eth-mainnet",
  "onchainTxHash": "text",
  "confirmations": 1,
  "explorerUrl": "text",
  "fromWalletId": "text",
  "toWalletId": "text",
  "currencyCode": "text",
  "amount": "text",
  "reference": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

Bridge assets between chains (optional module)

post

https://sandbox.sverse.iohttps://open.sverse.io

/v1/transactions/bridge

Optional module if Sverse provides bridging. If not, keep it disabled in MVP.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

fromChainKeystringRequiredExample: eth-mainnet

toChainKeystringRequiredExample: ton-mainnet

fromWalletIdstringRequired

toWalletIdstringRequired

idempotencyKeystring | nullableOptional

Responses

201

Bridge initiated

application/json

post

/v1/transactions/bridge

HTTPcURLJavaScriptPython

POST /v1/transactions/bridge HTTP/1.1
Host: sandbox.sverse.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 242

{
  "fromChainKey": "eth-mainnet",
  "toChainKey": "ton-mainnet",
  "fromWalletId": "text",
  "toWalletId": "text",
  "asset": {
    "assetType": "currency",
    "currencyCode": "text",
    "amount": "text",
    "nftRef": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  },
  "idempotencyKey": "text"
}

201

Bridge initiated

{
  "id": "tx_01HXYZ...",
  "projectId": "text",
  "type": "transfer",
  "status": "pending",
  "createdAt": "2026-01-19T11:19:09.886Z",
  "chainKey": "eth-mainnet",
  "onchainTxHash": "text",
  "confirmations": 1,
  "explorerUrl": "text",
  "fromWalletId": "text",
  "toWalletId": "text",
  "currencyCode": "text",
  "amount": "text",
  "reference": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}