Payout API

API for payouts

Get specific Payout

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

*/*

Response with payout data

idstringRequired

Payout ID

accountstringRequired

Merchant account ID

depositAddressstringRequired

Crypto address for deposit

amountnumberRequired

Withdrawal amount

currencystringRequired

This is the currency associated with the amount field

feenumberRequired

Service fee for the payout

feePercentagenumberRequired

Service fee in percentages

statestring · enumRequired

Represents status of the payout

Possible values:

createdDatestring · date-timeRequired

Time of payout creation

transactionHashstringOptional

Hash of the transaction in blockchain

commentstringOptional

Comment for the payout

executionDatestring · date-timeOptional

Execution date of payout. Can be used for payouts to date

idempotencyKeystring · uuidOptional

The external id that can be generated by user while creating the payout in the uuid format

belongingTypestring · enumRequired

Belonging type

Possible values:

externalIdstringOptional

External ID

400

Bad Request

*/*

500

Internal Server Error

*/*

post

/api/v1/payout

HTTPcURLJavaScriptPython

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

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "id": "text",
    "idempotencyKey": "123e4567-e89b-12d3-a456-426614174000"
  }
}

{
  "id": "text",
  "account": "text",
  "depositAddress": "text",
  "amount": 1,
  "currency": "text",
  "fee": 1,
  "feePercentage": 1,
  "state": "CREATION_IN_PROGRESS",
  "createdDate": "2026-02-24T18:03:01.846Z",
  "transactionHash": "text",
  "comment": "text",
  "executionDate": "2026-02-24T18:03:01.846Z",
  "idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
  "errors": {
    "withdrawalErrors": [
      {
        "withdrawalId": "text",
        "errors": [
          {
            "id": 1,
            "status": "SUCCESS",
            "errorResolved": true,
            "errorMessage": "text"
          }
        ]
      }
    ]
  },
  "cancellation": {
    "canceledByUserId": "text",
    "canceledByFirstname": "text",
    "canceledByLastname": "text",
    "cancelMessage": "text"
  },
  "belongingType": "INTERNAL",
  "externalId": "text"
}

Get specific Transaction from the Payout

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

*/*

Response with withdrawal data

idstringRequired

Id of the payout includes this transaction

accountstringRequired

Merchant account ID

companyNamestringOptional

Company of the user who created the payout

amountnumberRequired

Withdrawal amount

currencystringRequired

This is the currency associated with the amount field

statestring · enumRequired

Represents status of the withdrawal

Possible values:

feenumberRequired

Service fee for the withdrawal

transactionHashstringOptional

Transaction hash

depositAddressstringRequired

Recipient's crypto-address

commentstringOptional

Comment for the transaction

createdDatestring · date-timeRequired

Time of payout creation

belongingTypestring · enumRequired

Belonging type

Possible values:

400

Bad Request

*/*

500

Internal Server Error

*/*

post

/api/v1/payout/withdrawal

HTTPcURLJavaScriptPython

POST /api/v1/payout/withdrawal HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 63

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

{
  "id": "text",
  "account": "text",
  "companyName": "text",
  "amount": 1,
  "currency": "text",
  "state": "DRAFT",
  "fee": 1,
  "transactionHash": "text",
  "depositAddress": "text",
  "comment": "text",
  "createdDate": "2026-02-24T18:03:01.846Z",
  "withdrawalErrors": [
    {
      "id": 1,
      "status": "SUCCESS",
      "errorResolved": true,
      "errorMessage": "text"
    }
  ],
  "belongingType": "INTERNAL"
}

Get specific Transactions from the Payout

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/payout/withdrawal/all

HTTPcURLJavaScriptPython

POST /api/v1/payout/withdrawal/all HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 168

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "stateNames": [
      "DRAFT"
    ],
    "pageNumber": 1,
    "pageSize": 10,
    "dealId": "text",
    "idempotencyKey": "123e4567-e89b-12d3-a456-426614174000"
  }
}

{
  "result": [
    {
      "id": "text",
      "account": "text",
      "companyName": "text",
      "amount": 1,
      "currency": "text",
      "state": "DRAFT",
      "fee": 1,
      "transactionHash": "text",
      "depositAddress": "text",
      "comment": "text",
      "createdDate": "2026-02-24T18:03:01.846Z",
      "withdrawalErrors": [
        {
          "id": 1,
          "status": "SUCCESS",
          "errorResolved": true,
          "errorMessage": "text"
        }
      ],
      "belongingType": "INTERNAL"
    }
  ],
  "page": 1,
  "size": 1,
  "total": 1,
  "totalElements": 1
}

Get specific Mass Payout

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

*/*

Response with mass payout data

idstringRequired

Payout ID

idempotencyKeystring · uuidRequired

The external ID in the UUID format that can be generated by user while creating the payout

companyIdstring · uuidRequired

ID of the company created mass payout

accountstringRequired

Merchant account ID

statestring · enumRequired

Represents status of the payout

Possible values:

commentstringRequired

Comment for the payout

namestringOptional

Name of the payout

currencystringOptional

This is the currency associated with the amount field

totalWithdrawalAmountnumberOptional

Total amount of all transactions in a mass payout

totalFeenumberOptional

Total service fee for the mass payout

totalFeePercentagenumberOptional

Total service fee for the mass payout in percentages

executionDatestring · date-timeOptional

Execution date of payout. Time when payout will be executed

externalIdstringOptional

External ID

400

Bad Request

*/*

500

Internal Server Error

*/*

post

/api/v1/payout/mass

HTTPcURLJavaScriptPython

POST /api/v1/payout/mass HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 112

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "id": "text",
    "idempotencyKey": "123e4567-e89b-12d3-a456-426614174000"
  }
}

{
  "id": "text",
  "idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
  "companyId": "123e4567-e89b-12d3-a456-426614174000",
  "account": "text",
  "state": "CREATION_IN_PROGRESS",
  "comment": "text",
  "name": "text",
  "currency": "text",
  "totalWithdrawalAmount": 1,
  "totalFee": 1,
  "totalFeePercentage": 1,
  "executionDate": "2026-02-24T18:03:01.846Z",
  "errors": {
    "withdrawalErrors": [
      {
        "withdrawalId": "text",
        "errors": [
          {
            "id": 1,
            "status": "SUCCESS",
            "errorResolved": true,
            "errorMessage": "text"
          }
        ]
      }
    ]
  },
  "externalId": "text"
}

New Mass Payout

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

*/*

Response with mass payout data

idstringRequired

Payout ID

idempotencyKeystring · uuidRequired

The external ID in the UUID format that can be generated by user while creating the payout

companyIdstring · uuidRequired

ID of the company created mass payout

accountstringRequired

Merchant account ID

statestring · enumRequired

Represents status of the payout

Possible values:

commentstringRequired

Comment for the payout

namestringOptional

Name of the payout

currencystringOptional

This is the currency associated with the amount field

totalWithdrawalAmountnumberOptional

Total amount of all transactions in a mass payout

totalFeenumberOptional

Total service fee for the mass payout

totalFeePercentagenumberOptional

Total service fee for the mass payout in percentages

executionDatestring · date-timeOptional

Execution date of payout. Time when payout will be executed

externalIdstringOptional

External ID

400

Bad Request

*/*

500

Internal Server Error

*/*

post

/api/v1/payout/mass/create

HTTPcURLJavaScriptPython

POST /api/v1/payout/mass/create HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 284

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "currency": "text",
    "name": "text",
    "comment": "text",
    "massAddresses": [
      {
        "depositAddress": "text",
        "amount": 1,
        "comment": "text"
      }
    ],
    "executionDate": "2026-02-24T18:03:01.846Z",
    "idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
    "externalId": "text"
  }
}

{
  "id": "text",
  "idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
  "companyId": "123e4567-e89b-12d3-a456-426614174000",
  "account": "text",
  "state": "CREATION_IN_PROGRESS",
  "comment": "text",
  "name": "text",
  "currency": "text",
  "totalWithdrawalAmount": 1,
  "totalFee": 1,
  "totalFeePercentage": 1,
  "executionDate": "2026-02-24T18:03:01.846Z",
  "errors": {
    "withdrawalErrors": [
      {
        "withdrawalId": "text",
        "errors": [
          {
            "id": 1,
            "status": "SUCCESS",
            "errorResolved": true,
            "errorMessage": "text"
          }
        ]
      }
    ]
  },
  "externalId": "text"
}

Cancel Mass Payout

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

*/*

Response with mass payout data

idstringRequired

Payout ID

idempotencyKeystring · uuidRequired

The external ID in the UUID format that can be generated by user while creating the payout

companyIdstring · uuidRequired

ID of the company created mass payout

accountstringRequired

Merchant account ID

statestring · enumRequired

Represents status of the payout

Possible values:

commentstringRequired

Comment for the payout

namestringOptional

Name of the payout

currencystringOptional

This is the currency associated with the amount field

totalWithdrawalAmountnumberOptional

Total amount of all transactions in a mass payout

totalFeenumberOptional

Total service fee for the mass payout

totalFeePercentagenumberOptional

Total service fee for the mass payout in percentages

executionDatestring · date-timeOptional

Execution date of payout. Time when payout will be executed

externalIdstringOptional

External ID

400

Bad Request

*/*

500

Internal Server Error

*/*

post

/api/v1/payout/mass/cancel

HTTPcURLJavaScriptPython

POST /api/v1/payout/mass/cancel HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 133

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "dealId": "text",
    "idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
    "message": "text"
  }
}

{
  "id": "text",
  "idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
  "companyId": "123e4567-e89b-12d3-a456-426614174000",
  "account": "text",
  "state": "CREATION_IN_PROGRESS",
  "comment": "text",
  "name": "text",
  "currency": "text",
  "totalWithdrawalAmount": 1,
  "totalFee": 1,
  "totalFeePercentage": 1,
  "executionDate": "2026-02-24T18:03:01.846Z",
  "errors": {
    "withdrawalErrors": [
      {
        "withdrawalId": "text",
        "errors": [
          {
            "id": 1,
            "status": "SUCCESS",
            "errorResolved": true,
            "errorMessage": "text"
          }
        ]
      }
    ]
  },
  "externalId": "text"
}

Get all Mass Payouts

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/payout/mass/all

HTTPcURLJavaScriptPython

POST /api/v1/payout/mass/all HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 138

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "stateNames": [
      "CREATION_IN_PROGRESS"
    ],
    "isExecutionDateInFuture": true,
    "pageNumber": 1,
    "size": 10
  }
}

{
  "result": [
    {
      "id": "text",
      "idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
      "companyId": "123e4567-e89b-12d3-a456-426614174000",
      "account": "text",
      "state": "CREATION_IN_PROGRESS",
      "comment": "text",
      "name": "text",
      "currency": "text",
      "totalWithdrawalAmount": 1,
      "totalFee": 1,
      "totalFeePercentage": 1,
      "executionDate": "2026-02-24T18:03:01.846Z",
      "errors": {
        "withdrawalErrors": [
          {
            "withdrawalId": "text",
            "errors": [
              {
                "id": 1,
                "status": "SUCCESS",
                "errorResolved": true,
                "errorMessage": "text"
              }
            ]
          }
        ]
      },
      "externalId": "text"
    }
  ],
  "page": 1,
  "size": 1,
  "total": 1,
  "totalElements": 1
}

New Payout

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

*/*

Response with payout data

idstringRequired

Payout ID

accountstringRequired

Merchant account ID

depositAddressstringRequired

Crypto address for deposit

amountnumberRequired

Withdrawal amount

currencystringRequired

This is the currency associated with the amount field

feenumberRequired

Service fee for the payout

feePercentagenumberRequired

Service fee in percentages

statestring · enumRequired

Represents status of the payout

Possible values:

createdDatestring · date-timeRequired

Time of payout creation

transactionHashstringOptional

Hash of the transaction in blockchain

commentstringOptional

Comment for the payout

executionDatestring · date-timeOptional

Execution date of payout. Can be used for payouts to date

idempotencyKeystring · uuidOptional

The external id that can be generated by user while creating the payout in the uuid format

belongingTypestring · enumRequired

Belonging type

Possible values:

externalIdstringOptional

External ID

400

Bad Request

*/*

500

Internal Server Error

*/*

post

/api/v1/payout/create

HTTPcURLJavaScriptPython

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

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "depositAddress": "text",
    "amount": 1,
    "currency": "text",
    "comment": "text",
    "executionDate": "2026-02-24T18:03:01.846Z",
    "idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
    "externalId": "text"
  }
}

{
  "id": "text",
  "account": "text",
  "depositAddress": "text",
  "amount": 1,
  "currency": "text",
  "fee": 1,
  "feePercentage": 1,
  "state": "CREATION_IN_PROGRESS",
  "createdDate": "2026-02-24T18:03:01.846Z",
  "transactionHash": "text",
  "comment": "text",
  "executionDate": "2026-02-24T18:03:01.846Z",
  "idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
  "errors": {
    "withdrawalErrors": [
      {
        "withdrawalId": "text",
        "errors": [
          {
            "id": 1,
            "status": "SUCCESS",
            "errorResolved": true,
            "errorMessage": "text"
          }
        ]
      }
    ]
  },
  "cancellation": {
    "canceledByUserId": "text",
    "canceledByFirstname": "text",
    "canceledByLastname": "text",
    "cancelMessage": "text"
  },
  "belongingType": "INTERNAL",
  "externalId": "text"
}

Cancel Single Payout

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

*/*

Response with payout data

idstringRequired

Payout ID

accountstringRequired

Merchant account ID

depositAddressstringRequired

Crypto address for deposit

amountnumberRequired

Withdrawal amount

currencystringRequired

This is the currency associated with the amount field

feenumberRequired

Service fee for the payout

feePercentagenumberRequired

Service fee in percentages

statestring · enumRequired

Represents status of the payout

Possible values:

createdDatestring · date-timeRequired

Time of payout creation

transactionHashstringOptional

Hash of the transaction in blockchain

commentstringOptional

Comment for the payout

executionDatestring · date-timeOptional

Execution date of payout. Can be used for payouts to date

idempotencyKeystring · uuidOptional

The external id that can be generated by user while creating the payout in the uuid format

belongingTypestring · enumRequired

Belonging type

Possible values:

externalIdstringOptional

External ID

400

Bad Request

*/*

500

Internal Server Error

*/*

post

/api/v1/payout/cancel

HTTPcURLJavaScriptPython

POST /api/v1/payout/cancel HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 133

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "dealId": "text",
    "idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
    "message": "text"
  }
}

{
  "id": "text",
  "account": "text",
  "depositAddress": "text",
  "amount": 1,
  "currency": "text",
  "fee": 1,
  "feePercentage": 1,
  "state": "CREATION_IN_PROGRESS",
  "createdDate": "2026-02-24T18:03:01.846Z",
  "transactionHash": "text",
  "comment": "text",
  "executionDate": "2026-02-24T18:03:01.846Z",
  "idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
  "errors": {
    "withdrawalErrors": [
      {
        "withdrawalId": "text",
        "errors": [
          {
            "id": 1,
            "status": "SUCCESS",
            "errorResolved": true,
            "errorMessage": "text"
          }
        ]
      }
    ]
  },
  "cancellation": {
    "canceledByUserId": "text",
    "canceledByFirstname": "text",
    "canceledByLastname": "text",
    "cancelMessage": "text"
  },
  "belongingType": "INTERNAL",
  "externalId": "text"
}

Get all Payouts

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/payout/all

HTTPcURLJavaScriptPython

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

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "stateNames": [
      "CREATION_IN_PROGRESS"
    ],
    "isExecutionDateInFuture": true,
    "pageNumber": 1,
    "size": 10
  }
}

{
  "result": [
    {
      "id": "text",
      "account": "text",
      "depositAddress": "text",
      "amount": 1,
      "currency": "text",
      "fee": 1,
      "feePercentage": 1,
      "state": "CREATION_IN_PROGRESS",
      "createdDate": "2026-02-24T18:03:01.846Z",
      "transactionHash": "text",
      "comment": "text",
      "executionDate": "2026-02-24T18:03:01.846Z",
      "idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
      "errors": {
        "withdrawalErrors": [
          {
            "withdrawalId": "text",
            "errors": [
              {
                "id": 1,
                "status": "SUCCESS",
                "errorResolved": true,
                "errorMessage": "text"
              }
            ]
          }
        ]
      },
      "cancellation": {
        "canceledByUserId": "text",
        "canceledByFirstname": "text",
        "canceledByLastname": "text",
        "cancelMessage": "text"
      },
      "belongingType": "INTERNAL",
      "externalId": "text"
    }
  ],
  "page": 1,
  "size": 1,
  "total": 1,
  "totalElements": 1
}