THIS SITE IS UNDER CONSTRUCTION

Deriv Core API

Deposit

Testing

POST

/payment/transaction

deposit

Last modified:2025-03-11 03:41:02

This enpoint is used to deposit funds to client wallets.

Request

Header Params

Authorization

string

optional

Example:

x-client-id

string

optional

Optional only required for internal systems referrence.

Default:

Body Params multipart/form-data

string

optional

Example:

{{$string.alphanumeric(length=25,min=25,max=25,casing='lower',exclude='_!@#$%^&*()')}}

type

string

optional

Example:

receive

coin_symbol

string

optional

Example:

BTC

address_label

string

required

Example:

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/payment/transaction' \
--header 'Authorization: {{CLIENT_AUTH_TOKEN}}' \
--header 'x-client-id: {{RL_EXCLUSION_KEY}}' \
--form 'id="{{$string.alphanumeric(length=25,min=25,max=25,casing='\''lower'\'',exclude='\''_!@#$%^&*()'\'')}}"' \
--form 'type="receive"' \
--form 'coin_symbol="BTC"' \
--form 'address_label="{{WALLET_CLIENT_ID}}"'

Responses

🟢200Success

application/json

Body

data

array [object {15}]

required

integer

optional

amount

number

optional

client_id

integer

optional

type

string

optional

meta

object

required

endpoint

string

required

method

string

required

timing

integer

required

Example

{
  "data": [
    {
      "id": 422,
      "amount": 2,
      "client_id": 392,
      "type": "deposit",
      "category": "payment",
      "cashier": "crypto",
      "account": null,
      "staff_identifier": null,
      "remark": null,
      "payment_time": "2025-01-06T06:25:43.295684",
      "fee": 0,
      "wallet_id": 354,
      "status": "pending",
      "account_id": null
    }
  ],
  "meta": {
    "endpoint": "/payment/transaction",
    "method": "POST",
    "timing": 991
  }
}

🟠400Invalid Request

🟠401Unauthorised

Modified at 2025-03-11 03:41:02

Transactions

Exchange Rates