Settlement Wallet API

API for settlement wallet

Get a wallet

post

Permission annotations:

Header parameters

KeystringRequired

SignstringRequired

Body

application/json

Object with request data

accountstringRequired

Merchant account ID. Request will be sent for this account

timestampinteger · int64Required

Current unix UTC timestamp in milliseconds. Must not be less than 3 minutes in the past and not greater than 3 minutes in the future

Responses

200

OK

*/*

Data of the response to the action with the wallet

namestringRequired

Wallet name

addressstringRequired

Wallet address

blockchainstringRequired

Wallet blockchain

400

Bad Request

*/*

500

Internal Server Error

*/*

post

/api/v1/settlement/wallet

HTTPcURLJavaScriptPython

POST /api/v1/settlement/wallet HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 61

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "address": "text"
  }
}

{
  "name": "text",
  "address": "text",
  "blockchain": "text",
  "balances": [
    {
      "currency": "text",
      "amount": 1,
      "token": true
    }
  ]
}

Get transactions

post

Permission annotations:

Header parameters

KeystringRequired

SignstringRequired

Body

application/json

Object with request data

accountstringRequired

Merchant account ID. Request will be sent for this account

timestampinteger · int64Required

Current unix UTC timestamp in milliseconds. Must not be less than 3 minutes in the past and not greater than 3 minutes in the future

Responses

200

OK

*/*

Object with page details

pageinteger · int32Required

Numeric value indicating the page number

sizeinteger · int32Required

Numeric value indicating the page size

totalinteger · int32Required

Total number of pages matching the query

totalElementsinteger · int64Required

Total number of objects matching the query

400

Bad Request

*/*

500

Internal Server Error

*/*

post

/api/v1/settlement/wallet/transactions

HTTPcURLJavaScriptPython

POST /api/v1/settlement/wallet/transactions HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 191

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "walletAddress": "text",
    "addressTo": "text",
    "opcodes": [
      "WITHDRAWAL"
    ],
    "currency": "text",
    "pageNumber": 1,
    "pageSize": 10,
    "sort": "ASC",
    "properties": "text"
  }
}

{
  "result": [
    {
      "amount": 1,
      "currency": "text",
      "opCode": "WITHDRAWAL",
      "addressTo": "text",
      "serviceFee": 1,
      "serviceFeeCurrency": "text",
      "networkFee": 1,
      "networkFeeCurrency": "text",
      "transactionHash": "text",
      "createdDate": "2026-03-12T01:28:44.998Z"
    }
  ],
  "page": 1,
  "size": 1,
  "total": 1,
  "totalElements": 1
}

Rename wallet

post

Permission annotations:

Header parameters

KeystringRequired

SignstringRequired

Body

application/json

Object with request data

accountstringRequired

Merchant account ID. Request will be sent for this account

timestampinteger · int64Required

Current unix UTC timestamp in milliseconds. Must not be less than 3 minutes in the past and not greater than 3 minutes in the future

Responses

200

OK

No content

400

Bad Request

*/*

500

Internal Server Error

*/*

post

/api/v1/settlement/wallet/rename

HTTPcURLJavaScriptPython

POST /api/v1/settlement/wallet/rename HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 75

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "address": "text",
    "name": "text"
  }
}

No content

Get available operation codes

post

Permission annotations:

Header parameters

KeystringRequired

SignstringRequired

Body

application/json

Object with request data

accountstringRequired

Merchant account ID. Request will be sent for this account

timestampinteger · int64Required

Current unix UTC timestamp in milliseconds. Must not be less than 3 minutes in the past and not greater than 3 minutes in the future

Responses

200

OK

*/*

Data of the response to the request to obtain available operation codes

400

Bad Request

*/*

500

Internal Server Error

*/*

post

/api/v1/settlement/wallet/opcodes

HTTPcURLJavaScriptPython

POST /api/v1/settlement/wallet/opcodes HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 32

{
  "account": "text",
  "timestamp": 1
}

{
  "opCodes": [
    "WITHDRAWAL"
  ]
}

Create a wallet

post

Permission annotations:

Header parameters

KeystringRequired

SignstringRequired

Body

application/json

Object with request data

accountstringRequired

Merchant account ID. Request will be sent for this account

timestampinteger · int64Required

Current unix UTC timestamp in milliseconds. Must not be less than 3 minutes in the past and not greater than 3 minutes in the future

Responses

200

OK

*/*

Data of the response to the action with the wallet

namestringRequired

Wallet name

addressstringRequired

Wallet address

blockchainstringRequired

Wallet blockchain

400

Bad Request

*/*

500

Internal Server Error

*/*

post

/api/v1/settlement/wallet/create

HTTPcURLJavaScriptPython

POST /api/v1/settlement/wallet/create HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 78

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "name": "text",
    "blockchain": "text"
  }
}

{
  "name": "text",
  "address": "text",
  "blockchain": "text",
  "balances": [
    {
      "currency": "text",
      "amount": 1,
      "token": true
    }
  ]
}

Archive wallet

post

Permission annotations:

Header parameters

KeystringRequired

SignstringRequired

Body

application/json

Object with request data

accountstringRequired

Merchant account ID. Request will be sent for this account

timestampinteger · int64Required

Current unix UTC timestamp in milliseconds. Must not be less than 3 minutes in the past and not greater than 3 minutes in the future

Responses

200

OK

No content

400

Bad Request

*/*

500

Internal Server Error

*/*

post

/api/v1/settlement/wallet/archive

HTTPcURLJavaScriptPython

POST /api/v1/settlement/wallet/archive HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 61

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "address": "text"
  }
}

No content

Get wallets

post

Permission annotations:

Header parameters

KeystringRequired

SignstringRequired

Body

application/json

Object with request data

accountstringRequired

Merchant account ID. Request will be sent for this account

timestampinteger · int64Required

Current unix UTC timestamp in milliseconds. Must not be less than 3 minutes in the past and not greater than 3 minutes in the future

Responses

200

OK

*/*

Object with page details

pageinteger · int32Required

Numeric value indicating the page number

sizeinteger · int32Required

Numeric value indicating the page size

totalinteger · int32Required

Total number of pages matching the query

totalElementsinteger · int64Required

Total number of objects matching the query

400

Bad Request

*/*

500

Internal Server Error

*/*

post

/api/v1/settlement/wallet/all

HTTPcURLJavaScriptPython

POST /api/v1/settlement/wallet/all HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 167

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "blockchain": "text",
    "currency": "text",
    "nameOrAddress": "text",
    "pageNumber": 1,
    "pageSize": 10,
    "sort": "ASC",
    "properties": "text"
  }
}

{
  "result": [
    {
      "name": "text",
      "address": "text",
      "blockchain": "text",
      "balances": [
        {
          "currency": "text",
          "amount": 1,
          "token": true
        }
      ]
    }
  ],
  "page": 1,
  "size": 1,
  "total": 1,
  "totalElements": 1
}