Organization

Explore resources

Endpoint paths, field names and enum values appear exactly as the API uses them. Some carry legacy names, such as earn_clients. They are identifiers, not product descriptions.

GET/organization/balances/

Get organization balances

Header parameters

Name	Type	Description
apikeystringrequired	string	API key issued to the integration partner.

Responses

200OK

application/jsonarray of BalanceResponse

Name	Type	Description
asset_idstring	string	Id of the asset, refer to response from /assets/ endpoint
available_for_withdrawalstring	string	Amount currently available to request for withdrawal.
earn_totalstring	string	Cumulative total since creation of this client account.
earn_90dstring	string
earn_30dstring	string
earn_7dstring	string
earn_1dstring	string
totalstring	string	DEPRECATED. Please use `total_balance` instead
last_payout_datestring (date-time)	string (date-time)	Can be null if no payouts have been made yet.
last_payout_amountstring	string	Can be null if no payouts have been made yet.
total_balancestringrequired	string	Total current balance for a given asset ID.

Example

[
  {
    "asset_id": "USDC",
    "available_for_withdrawal": "string",
    "earn_total": "string",
    "earn_90d": "string",
    "earn_30d": "string",
    "earn_7d": "string",
    "earn_1d": "string",
    "total": "string",
    "total_balance": "string",
    "last_payout_date": "2022-12-10T09:30Z",
    "last_payout_amount": "string"
  }
]

400Bad Request

application/jsonarray of Error

Name	Type	Description
field_namestring	string
error_detailsarray of ErrorDetailrequired	array of ErrorDetail
error_details[].messagestring	string
error_details[].codestring	string

Example

[
  {
    "field_name": "string",
    "error_details": [
      {
        "message": "string",
        "code": "string"
      },
      {
        "message": "string",
        "code": "string"
      }
    ]
  }
]

401Unauthorized

POST/organization/deposit/notify/

Notify about a new deposit transaction

Header parameters

Name	Type	Description
apikeystringrequired	string	API key issued to the integration partner.

Request body

application/jsonrequired

Name	Type	Description
txhash_urlstringrequired	string
amountstringrequired	string
asset_idstringrequired	string	Id of the asset, refer to response from /assets/ endpoint
productstringrequired	string	Allowed values: `highyield`
tx_timestampstring (date-time)required	string (date-time)

Example

{
  "txhash_url": "string",
  "amount": "string",
  "asset_id": "string",
  "product": "highyield",
  "tx_timestamp": "string"
}

Responses

204no content

GET/organization/transactions/

Get organization transaction history

Transaction list on organization level does not include transactions for individual sub-clients. Use this operation to check status of in-progress withdrawal requests.

Header parameters

Name	Type	Description
apikeystringrequired	string	API key issued to the integration partner.

Query parameters

Name	Type	Description
transaction_idstring	string
skipinteger	integer	Specify how many transactions to skip starting from the first one
takeinteger	integer	Specify how many transactions to take
asset_idstring	string

Responses

200List of transaction's statuses

application/json

Name	Type	Description
countinteger	integer	Count of all objects
resultsarray of OrganizationTransactionResponse	array of OrganizationTransactionResponse
results[].idstring	string	Coinchange unique transaction reference
results[].statusstring	string	Allowed values: `REQUESTED`, `TRANSFERRED_OUT`, `SENDING`, `SUCCESS`, `FAILED`
results[].destination_addressstring	string
results[].notestring	string
results[].external_tx_idstring	string	Transaction id passed to Coinchange by an external system in the original withdrawal request.
results[].asset_idstring	string	Id of the asset, refer to response from /assets/ endpoint
results[].created_atstring (date-time)	string (date-time)
results[].modified_atstring (date-time)	string (date-time)
results[].txhashstring	string
results[].txhash_urlstring	string
results[].transaction_typestring	string	Allowed values: `EARN`, `DEPOSIT`, `WITHDRAWAL`
results[].gross_amountstring	string
results[].fee_amountstring	string
results[].net_amountstring	string

Example

{
  "count": 0,
  "results": [
    {
      "id": "string",
      "status": "SUCCESS",
      "destination_address": "string",
      "note": "string",
      "external_tx_id": "string",
      "asset_id": "USDT",
      "gross_amount": "string",
      "net_amount": "string",
      "fee_amount": "string",
      "created_at": "2022-12-10T09:30Z",
      "modified_at": "2022-12-10T09:30Z",
      "txhash": "string",
      "txhash_url": "string",
      "transaction_type": "DEPOSIT"
    }
  ]
}

401Unauthorized

POST/organization/transactions/validate_withdrawal_request/

Perform pre-submission withdrawal request validation

Pre-validate withdrawal request to receive information such as the fee that will be applied, net amount to be received, and any messages.

Header parameters

Name	Type	Description
apikeystringrequired	string	API key issued to the integration partner.

Request body

application/jsonrequired

Name	Type	Description
amountstringrequired	string
destination_addressstringrequired	string
external_tx_idstring	string
asset_idstringrequired	string	Id of the asset, refer to response from /assets/ endpoint

Example

{
  "amount": "string",
  "destination_address": "string",
  "external_tx_id": "string",
  "asset_id": "USDT"
}

Responses

200OK

application/json

Name	Type	Description
gross_amountstring	string
net_amountstring	string
fee_amountstring	string
withdrawal_statusstring	string	Allowed values: `Success`
messagestring	string

Example

{
  "gross_amount": "string",
  "net_amount": "string",
  "fee_amount": "string",
  "withdrawal_status": "Success",
  "message": "string"
}

400Bad Request

401Unauthorized

POST/organization/transactions/withdraw/

Create withdrawal request

Header parameters

Name	Type	Description
apikeystringrequired	string	API key issued to the integration partner.

Request body

application/jsonrequired

Name	Type	Description
amountstringrequired	string
destination_addressstringrequired	string
external_tx_idstring	string
asset_idstringrequired	string	Id of the asset, refer to response from /assets/ endpoint

Example

{
  "amount": "string",
  "destination_address": "string",
  "external_tx_id": "string",
  "asset_id": "USDT"
}

Responses

201OK

application/json

Name	Type	Description
idstring	string	Coinchange unique transaction reference
statusstring	string	Allowed values: `REQUESTED`, `TRANSFERRED_OUT`, `SENDING`, `SUCCESS`, `FAILED`
client_idstring	string	Client id provided to Coinchange when client was initially created by external system
destination_addressstring	string
notestring	string
external_tx_idstring	string	Transaction id passed to Coinchange by an external system in the original withdrawal request.
asset_idstring	string	Id of the asset, refer to response from /assets/ endpoint
created_atstring (date-time)	string (date-time)
modified_atstring (date-time)	string (date-time)
txhashstring	string
txhash_urlstring	string
transaction_typestring	string	Allowed values: `EARN`, `DEPOSIT`, `WITHDRAW`
fee_amountstring	string
gross_amountstring	string
net_amountstring	string

Example

{
  "id": "string",
  "status": "TRANSFERRED_OUT",
  "client_id": "string",
  "destination_address": "string",
  "note": "string",
  "external_tx_id": "string",
  "asset_id": "USDC",
  "gross_amount": "string",
  "net_amount": "string",
  "fee_amount": "string",
  "created_at": "2022-06-12T19:27:12.895815Z",
  "modified_at": "2022-06-16T09:45:43.896465Z",
  "txhash": "string",
  "txhash_url": "string",
  "transaction_type": "WITHDRAW"
}

400Bad Request

application/jsonarray of Error

Name	Type	Description
field_namestring	string
error_detailsarray of ErrorDetailrequired	array of ErrorDetail
error_details[].messagestring	string
error_details[].codestring	string

Example

[
  {
    "field_name": "string",
    "error_details": [
      {
        "message": "string",
        "code": "string"
      },
      {
        "message": "string",
        "code": "string"
      }
    ]
  }
]

401Unauthorized

GET/organization/wallets/deposit/

Get organization deposit addresses

Header parameters

Name	Type	Description
apikeystringrequired	string	API key issued to the integration partner.

Query parameters

Name	Type	Description
asset_idstringrequired	string

Responses

200OK

application/jsonarray of DepositWallet

Name	Type	Description
addressstring	string
asset_idstring	string
nicknamestring	string

Example

[
  {
    "asset_id": "USDT",
    "address": "string",
    "nickname": "string"
  }
]

400Bad Request

application/jsonarray of Error

Name	Type	Description
field_namestring	string
error_detailsarray of ErrorDetailrequired	array of ErrorDetail
error_details[].messagestring	string
error_details[].codestring	string

Example

[
  {
    "field_name": "string",
    "error_details": [
      {
        "message": "string",
        "code": "string"
      },
      {
        "message": "string",
        "code": "string"
      }
    ]
  }
]

401Unauthorized

GET/organization/wallets/withdrawal/

Get organization withdrawal addresses

Header parameters

Name	Type	Description
apikeystringrequired	string	API key issued to the integration partner.

Responses

200OK

application/jsonarray of WithdrawalWallet

Name	Type	Description
addressstring	string
asset_idstring	string	Id of the asset, refer to response from /assets/ endpoint
nicknamestring	string

Example

[
  {
    "asset_id": "USDT",
    "address": "string",
    "nickname": "string"
  }
]

400Bad Request

application/jsonarray of Error

Name	Type	Description
field_namestring	string
error_detailsarray of ErrorDetailrequired	array of ErrorDetail
error_details[].messagestring	string
error_details[].codestring	string

Example

[
  {
    "field_name": "string",
    "error_details": [
      {
        "message": "string",
        "code": "string"
      },
      {
        "message": "string",
        "code": "string"
      }
    ]
  }
]

401Unauthorized

Technical documentation is provided to institutional integration partners for integration work. It is not an offer or a solicitation. Availability of products, assets and endpoints varies by partner and jurisdiction.

Back to API reference