Currencies

Get withdrawals

get

Perform a currency withdrawal from specific address

Path parameters

currencyIdstring · uuidRequired

Currency UUID identifier, globally unique to Axiology TSS

Example: f841b418-eafd-4ee1-950e-5836b4e9b2c7

Query parameters

Responses

200

Successfully retrieved a list of items.

application/json

get

/currencies/{currencyId}/withdrawals

HTTPcURLJavaScriptPython

GET /currencies/{currencyId}/withdrawals HTTP/1.1
Accept: */*

200

Successfully retrieved a list of items.

{
  "pagination": {
    "size": 10,
    "page": 1,
    "totalItems": 25,
    "totalPages": 3
  },
  "items": [
    {
      "createdAt": "2026-03-22T12:30:18.126Z",
      "updatedAt": "2026-03-22T12:30:18.126Z",
      "id": "3d152bdd-1ec8-4bb0-93c8-def401747014",
      "brokerId": "d449e186-da32-4e0e-b418-66a0c646403e",
      "currencyId": "84ffdd88-db29-4e44-b081-0a31235bbf47",
      "accountAddress": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
      "iban": "LT601010012345678901",
      "amount": 10000,
      "status": "withdrawn",
      "transactionId": "123456789012345678",
      "correlationId": "3d152bdd-1ec8-4bb0-93c8-def401747014"
    }
  ]
}

Initiate withdrawal

post

Perform a currency withdrawal, specified by currency id in the path, source address should hold some balance of that currency

Path parameters

currencyIdstring · uuidRequired

Currency UUID identifier, globally unique to Axiology TSS

Example: f841b418-eafd-4ee1-950e-5836b4e9b2c7

Body

application/json

accountAddressstring · xrp-addressRequired

Source account address to withdraw from

Example: rHb9CJAWyB4rj91VRWn96DkukG4bwdtyThPattern: r[0-9a-zA-Z]{24,34}

amountinteger · int64Required

Amount to withdraw in sub-units

Example: 10000

ibanstring · iban · min: 15 · max: 34Required

Destination IBAN that withdrawal should be sent to

Example: LT601010012345678901Pattern: ^[A-Z]{2}[0-9]{2}[A-Z0-9]{1,30}$

Responses

201

Withdrawal details

application/json

post

/currencies/{currencyId}/withdrawals

HTTPcURLJavaScriptPython

POST /currencies/{currencyId}/withdrawals HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 100

{
  "accountAddress": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
  "amount": 10000,
  "iban": "LT601010012345678901"
}

201

Withdrawal details

{
  "createdAt": "2026-03-22T12:30:18.126Z",
  "updatedAt": "2026-03-22T12:30:18.126Z",
  "id": "3d152bdd-1ec8-4bb0-93c8-def401747014",
  "brokerId": "d449e186-da32-4e0e-b418-66a0c646403e",
  "currencyId": "84ffdd88-db29-4e44-b081-0a31235bbf47",
  "accountAddress": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
  "iban": "LT601010012345678901",
  "amount": 10000,
  "status": "withdrawn",
  "transactionId": "123456789012345678",
  "correlationId": "3d152bdd-1ec8-4bb0-93c8-def401747014"
}

Get currencies

get

Retrieve a list of currencies supported by the platform

Query parameters

modestring · enumOptional

Strategy applied when filtering/searching on multiple fields

Possible values:

Responses

200

Successfully retrieved a list of items.

application/json

get

/currencies

HTTPcURLJavaScriptPython

GET /currencies HTTP/1.1
Accept: */*

200

Successfully retrieved a list of items.

{
  "pagination": {
    "size": 10,
    "page": 1,
    "totalItems": 25,
    "totalPages": 3
  },
  "items": [
    {
      "createdAt": "2026-03-22T12:30:18.126Z",
      "updatedAt": "2026-03-22T12:30:18.126Z",
      "id": "f6bb6c1e-047d-4166-bf06-e8d5f4edd014",
      "name": "Euro",
      "code": "EUR",
      "exponent": 0,
      "supplyLimit": 1000000000,
      "issuingAccountAddress": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
      "operationalAccountAddress": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh"
    }
  ]
}

Get currency

get

Retrieve full information about a single currency, specified by currency id in the path

Path parameters

currencyIdstring · uuidRequired

Currency UUID identifier, globally unique to Axiology TSS

Example: f841b418-eafd-4ee1-950e-5836b4e9b2c7

Responses

200Success

application/json

createdAtstring · date-timeRequired

Created date

updatedAtstring · date-timeRequired

Updated date

idstring · uuidRequired

UUIDv4 currency id / Asset id - unique in scope of this node

Example: f6bb6c1e-047d-4166-bf06-e8d5f4edd014

namestringRequired

Full name of the currency

Example: Euro

codestringRequired

Unique code of the currency

Example: EUR

exponentnumber · max: 10Required

Exponent - number of decimal places (scale) used for this asset or currency.

• Decimal floating value: stored_value / 10^exponent.
• Values are stored in the smallest accountable/divisible unit (e.g., cents when exponent = 2).
• Examples: 2000 with exponent 2 => 20; 2345 with exponent 3 => 2.345; 2345 with exponent 0 => 2345.

Example: 2

supplyLimitinteger · int64Required

Maximum amount of currency allowed in circulation

Example: 1000000000

issuingAccountAddressstring · xrp-addressRequired

Issuing account address

Example: rHb9CJAWyB4rj91VRWn96DkukG4bwdtyThPattern: r[0-9a-zA-Z]{24,34}

operationalAccountAddressstring · xrp-addressRequired

Operational account address

Example: rHb9CJAWyB4rj91VRWn96DkukG4bwdtyThPattern: r[0-9a-zA-Z]{24,34}

get

/currencies/{currencyId}

HTTPcURLJavaScriptPython

GET /currencies/{currencyId} HTTP/1.1
Accept: */*

200Success

{
  "createdAt": "2026-03-22T12:30:18.126Z",
  "updatedAt": "2026-03-22T12:30:18.126Z",
  "id": "f6bb6c1e-047d-4166-bf06-e8d5f4edd014",
  "name": "Euro",
  "code": "EUR",
  "exponent": 0,
  "supplyLimit": 1000000000,
  "issuingAccountAddress": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
  "operationalAccountAddress": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
  "issuingAccount": {
    "createdAt": "2026-03-22T12:30:18.126Z",
    "updatedAt": "2026-03-22T12:30:18.126Z",
    "address": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
    "amount": 10000
  },
  "operationalAccount": {
    "createdAt": "2026-03-22T12:30:18.126Z",
    "updatedAt": "2026-03-22T12:30:18.126Z",
    "address": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
    "amount": 10000
  }
}

Get deposits

get

Get a paginated list of currency's deposits information in the system

Path parameters

currencyIdstring · uuidRequired

Currency UUID identifier, globally unique to Axiology TSS

Example: f841b418-eafd-4ee1-950e-5836b4e9b2c7

Query parameters

Responses

200

Successfully retrieved a list of items.

application/json

get

/currencies/{currencyId}/deposits

HTTPcURLJavaScriptPython

GET /currencies/{currencyId}/deposits HTTP/1.1
Accept: */*

200

Successfully retrieved a list of items.

{
  "pagination": {
    "size": 10,
    "page": 1,
    "totalItems": 25,
    "totalPages": 3
  },
  "items": [
    {
      "createdAt": "2026-03-22T12:30:18.126Z",
      "updatedAt": "2026-03-22T12:30:18.126Z",
      "id": "b18c0893-f86b-4477-a267-7b46d623be72",
      "brokerId": "669ed9a5-1ff4-41d4-9214-a28d0df194c4",
      "currencyId": "9d28e972-6028-4355-a800-c392a1a2384e",
      "accountAddress": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
      "iban": "LT601010012345678901",
      "amount": 10000,
      "status": "deposited",
      "transactionId": "123456789012345678",
      "correlationId": "b18c0893-f86b-4477-a267-7b46d623be72"
    }
  ]
}

Get deposit

get

Retrieve full information about a single deposit, specified by deposit id in the path

Path parameters

currencyIdstring · uuidRequired

Currency UUID identifier, globally unique to Axiology TSS

Example: f841b418-eafd-4ee1-950e-5836b4e9b2c7

depositIdstring · uuidRequired

Deposit UUID identifier, globally unique to Axiology TSS

Example: a961a9e2-1d65-4b58-b835-6776fa6b0a71

Responses

200

Successfully received a deposit

application/json

createdAtstring · date-timeRequired

Created date

updatedAtstring · date-timeRequired

Updated date

idstring · uuidRequired

Deposit UUID identifier

Example: b18c0893-f86b-4477-a267-7b46d623be72

brokerIdstring · uuidRequired

Broker UUID identifier

Example: 669ed9a5-1ff4-41d4-9214-a28d0df194c4

currencyIdstring · uuidRequired

Currency UUID identifier

Example: 9d28e972-6028-4355-a800-c392a1a2384e

accountAddressstring · xrp-addressRequired

Destination account address

Example: rHb9CJAWyB4rj91VRWn96DkukG4bwdtyThPattern: r[0-9a-zA-Z]{24,34}

ibanstring · iban · min: 15 · max: 34Required

Source IBAN

Example: LT601010012345678901Pattern: ^[A-Z]{2}[0-9]{2}[A-Z0-9]{1,30}$

amountinteger · int64Required

Deposit amount in sub-units

Example: 10000

statusstring · enumRequired

Status of deposit

Possible values:

transactionIdstring · iso-20022-payment-tx-id · min: 10 · max: 35Required

SEPA payment's Transaction Id

Example: 123456789012345678

correlationIdstring · uuidRequired

Correlation id for end-to-end referencing

Example: b18c0893-f86b-4477-a267-7b46d623be72

get

/currencies/{currencyId}/deposits/{depositId}

HTTPcURLJavaScriptPython

GET /currencies/{currencyId}/deposits/{depositId} HTTP/1.1
Accept: */*

200

Successfully received a deposit

{
  "createdAt": "2026-03-22T12:30:18.126Z",
  "updatedAt": "2026-03-22T12:30:18.126Z",
  "id": "b18c0893-f86b-4477-a267-7b46d623be72",
  "brokerId": "669ed9a5-1ff4-41d4-9214-a28d0df194c4",
  "currencyId": "9d28e972-6028-4355-a800-c392a1a2384e",
  "accountAddress": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
  "iban": "LT601010012345678901",
  "amount": 10000,
  "status": "deposited",
  "transactionId": "123456789012345678",
  "correlationId": "b18c0893-f86b-4477-a267-7b46d623be72"
}

Get withdrawal

get

Retrieve full information about a single withdrawal, specified by withdrawal id in the path

Path parameters

currencyIdstring · uuidRequired

Currency UUID identifier, globally unique to Axiology TSS

Example: f841b418-eafd-4ee1-950e-5836b4e9b2c7

withdrawalIdstring · uuidRequired

Withdrawal UUID identifier, globally unique to Axiology TSS

Example: d75c707a-c37e-494f-826e-a54d01557aad

Responses

200

Successfully received a withdrawal

application/json

createdAtstring · date-timeRequired

Created date

updatedAtstring · date-timeRequired

Updated date

idstring · uuidRequired

Withdrawal UUID identifier

Example: 3d152bdd-1ec8-4bb0-93c8-def401747014

brokerIdstring · uuidRequired

Broker UUID identifier

Example: d449e186-da32-4e0e-b418-66a0c646403e

currencyIdstring · uuidRequired

Currency UUID identifier

Example: 84ffdd88-db29-4e44-b081-0a31235bbf47

accountAddressstring · xrp-addressRequired

Source account address

Example: rHb9CJAWyB4rj91VRWn96DkukG4bwdtyThPattern: r[0-9a-zA-Z]{24,34}

ibanstring · iban · min: 15 · max: 34Required

Destination IBAN

Example: LT601010012345678901Pattern: ^[A-Z]{2}[0-9]{2}[A-Z0-9]{1,30}$

amountinteger · int64Required

Withdrawal amount in sub-units

Example: 10000

statusstring · enumRequired

Status of withdrawal

Possible values:

transactionIdstring · iso-20022-payment-tx-id · min: 10 · max: 35 · nullableRequired

SEPA payment's Transaction Id

Example: 123456789012345678

correlationIdstring · uuidRequired

Correlation id for end-to-end referencing

Example: 3d152bdd-1ec8-4bb0-93c8-def401747014

get

/currencies/{currencyId}/withdrawals/{withdrawalId}

HTTPcURLJavaScriptPython

GET /currencies/{currencyId}/withdrawals/{withdrawalId} HTTP/1.1
Accept: */*

200

Successfully received a withdrawal

{
  "createdAt": "2026-03-22T12:30:18.126Z",
  "updatedAt": "2026-03-22T12:30:18.126Z",
  "id": "3d152bdd-1ec8-4bb0-93c8-def401747014",
  "brokerId": "d449e186-da32-4e0e-b418-66a0c646403e",
  "currencyId": "84ffdd88-db29-4e44-b081-0a31235bbf47",
  "accountAddress": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
  "iban": "LT601010012345678901",
  "amount": 10000,
  "status": "withdrawn",
  "transactionId": "123456789012345678",
  "correlationId": "3d152bdd-1ec8-4bb0-93c8-def401747014"
}

get

Retrieve a list of accounts with balance for specified currency.

Path parameters

currencyIdstring · uuidRequired

Currency UUID identifier, globally unique to Axiology TSS

Example: f841b418-eafd-4ee1-950e-5836b4e9b2c7

Query parameters

Responses

200

Successfully retrieved a list of items.

application/json

get

/currencies/{currencyId}/accounts

HTTPcURLJavaScriptPython

GET /currencies/{currencyId}/accounts HTTP/1.1
Accept: */*

200

Successfully retrieved a list of items.

{
  "pagination": {
    "size": 10,
    "page": 1,
    "totalItems": 25,
    "totalPages": 3
  },
  "items": [
    {
      "account": {
        "createdAt": "2026-03-22T12:30:18.126Z",
        "updatedAt": "2026-03-22T12:30:18.126Z",
        "nodeId": "fb098963-aa15-48e0-94cf-84d5b3829044",
        "address": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
        "type": "investor",
        "institutionSectorCode": "S.11",
        "walletType": "client-individual",
        "status": "active",
        "openedAt": "2026-03-22T12:30:18.126Z"
      },
      "amount": 1000
    }
  ]
}

get

Encode payment description

Query parameters

addressstring · xrp-addressRequired

Source or destination account address

Example: rHb9CJAWyB4rj91VRWn96DkukG4bwdtyThPattern: r[0-9a-zA-Z]{24,34}

Responses

200Success

application/json

descriptionstringRequired

Encoded payment description

Example: LMRHEQSBMF2GITCMOY4TCQJSKJJTEM3TKFXFEYZRGNXWQRLKPBITO2SBLIRCYIRWMU3TKZBVGBQS2MJQGQYS2NBWMFRC2ODEME2S2MJTHEZTKMJUHEYWCNDDEJOQ

correlationIdstring · uuidRequired

Correlation id for end-to-end referencing

Example: 3252c282-fd9f-4af3-ab9d-c1334cd2d5ce

get

/utils/description/encode

HTTPcURLJavaScriptPython

GET /utils/description/encode?address=rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh HTTP/1.1
Accept: */*

200Success

{
  "description": "LMRHEQSBMF2GITCMOY4TCQJSKJJTEM3TKFXFEYZRGNXWQRLKPBITO2SBLIRCYIRWMU3TKZBVGBQS2MJQGQYS2NBWMFRC2ODEME2S2MJTHEZTKMJUHEYWCNDDEJOQ",
  "correlationId": "3252c282-fd9f-4af3-ab9d-c1334cd2d5ce"
}

get

Decode payment description

Query parameters

descriptionstringRequired

Encoded payment description

Example: LMRHEQSBMF2GITCMOY4TCQJSKJJTEM3TKFXFEYZRGNXWQRLKPBITO2SBLIRCYIRWMU3TKZBVGBQS2MJQGQYS2NBWMFRC2ODEME2S2MJTHEZTKMJUHEYWCNDDEJOQ

Responses

200Success

application/json

addressstring · xrp-addressRequired

Source or destination address on the blockchain

Example: rHb9CJAWyB4rj91VRWn96DkukG4bwdtyThPattern: r[0-9a-zA-Z]{24,34}

correlationIdstring · uuidRequired

Correlation id for end-to-end referencing

Example: f4a3c91d-14ee-4a97-881b-5979a3585fad

get

/utils/description/decode

HTTPcURLJavaScriptPython

GET /utils/description/decode?description=LMRHEQSBMF2GITCMOY4TCQJSKJJTEM3TKFXFEYZRGNXWQRLKPBITO2SBLIRCYIRWMU3TKZBVGBQS2MJQGQYS2NBWMFRC2ODEME2S2MJTHEZTKMJUHEYWCNDDEJOQ HTTP/1.1
Accept: */*

200Success

{
  "address": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
  "correlationId": "f4a3c91d-14ee-4a97-881b-5979a3585fad"
}