Fiat deposit API

API for fiat deposit

Get fiat info

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

*/*

Order response

externalAddressstringOptional

External address

idstring · uuidRequired

Id

cryptoAmountnumberOptional

Amount in crypto

fiatAmountnumberOptional

Amount in fiat

fiatCurrencystringRequired

Fiat Currency

currencystringRequired

Тикер валюты

statestring · enumRequired

State

Possible values:

hashstringOptional

Hash

400

Bad Request

*/*

500

Internal Server Error

*/*

post

/api/v1/fiat/deposit/order

HTTPcURLJavaScriptPython

POST /api/v1/fiat/deposit/order HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 88

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

{
  "externalAddress": "text",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "cryptoAmount": 1,
  "fiatAmount": 1,
  "fiatCurrency": "text",
  "currency": "text",
  "state": "CREATED",
  "hash": "text"
}

Get method

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

*/*

Payment method response

fixedRateIdstring · uuidRequired

Rate id

rateExpiredDatestring · date-timeRequired

Rate expired date

400

Bad Request

*/*

500

Internal Server Error

*/*

post

/api/v1/fiat/deposit/method

HTTPcURLJavaScriptPython

POST /api/v1/fiat/deposit/method HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 164

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "itemId": "123e4567-e89b-12d3-a456-426614174000",
    "fiatCurrency": "text",
    "cryptoAmount": 1,
    "fiatAmount": 1,
    "currency": "text"
  }
}

{
  "fixedRateId": "123e4567-e89b-12d3-a456-426614174000",
  "rateExpiredDate": "2026-02-24T22:17:16.487Z",
  "methods": [
    {
      "itemId": "123e4567-e89b-12d3-a456-426614174000",
      "paymentMethodCode": "text",
      "paymentMethodName": "text",
      "fiatAmount": 1,
      "cryptoAmount": 1,
      "currency": "text",
      "fiatCurrency": "text",
      "minLimit": 1,
      "maxLimit": 1
    }
  ]
}

Generate key

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

*/*

Access key response

keystring · uuidRequired

Access key

expiredAtstring · date-timeRequired

Access key expired date

400

Bad Request

*/*

500

Internal Server Error

*/*

post

/api/v1/fiat/deposit/key/generate

HTTPcURLJavaScriptPython

POST /api/v1/fiat/deposit/key/generate HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 32

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

{
  "key": "123e4567-e89b-12d3-a456-426614174000",
  "expiredAt": "2026-02-24T22:17:16.487Z"
}

Get available fiat currencies

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

*/*

FiatCurrency list response

fiatCurrenciesstring[]Required

List of available fiat currencies

400

Bad Request

*/*

500

Internal Server Error

*/*

post

/api/v1/fiat/deposit/fiatCurrencies

HTTPcURLJavaScriptPython

POST /api/v1/fiat/deposit/fiatCurrencies HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 32

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

{
  "fiatCurrencies": [
    "text"
  ]
}

Create order

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

*/*

Order response

externalAddressstringOptional

External address

idstring · uuidRequired

Id

cryptoAmountnumberOptional

Amount in crypto

fiatAmountnumberOptional

Amount in fiat

fiatCurrencystringRequired

Fiat Currency

currencystringRequired

Тикер валюты

statestring · enumRequired

State

Possible values:

hashstringOptional

Hash

400

Bad Request

*/*

500

Internal Server Error

*/*

post

/api/v1/fiat/deposit/create/order

HTTPcURLJavaScriptPython

POST /api/v1/fiat/deposit/create/order HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 321

{
  "account": "text",
  "timestamp": 1,
  "payload": {
    "rateId": "123e4567-e89b-12d3-a456-426614174000",
    "itemId": "123e4567-e89b-12d3-a456-426614174000",
    "cryptoAmount": 1,
    "fiatAmount": 1,
    "description": "text",
    "merchantExternalId": "text",
    "returnUrl": "text",
    "idempotencyKey": "123e4567-e89b-12d3-a456-426614174000",
    "externalAddress": "text"
  }
}

{
  "externalAddress": "text",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "cryptoAmount": 1,
  "fiatAmount": 1,
  "fiatCurrency": "text",
  "currency": "text",
  "state": "CREATED",
  "hash": "text"
}

Confirm order

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

*/*

Redirect URL response

redirectUrlstringRequired

Redirect URL

400

Bad Request

*/*

500

Internal Server Error

*/*

post

/api/v1/fiat/deposit/confirm/order

HTTPcURLJavaScriptPython

POST /api/v1/fiat/deposit/confirm/order HTTP/1.1
Host: api.calypso.finance
Key: text
Sign: text
Content-Type: application/json
Accept: */*
Content-Length: 135

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

{
  "redirectUrl": "text"
}