Create Account

POST

Auth required

Create a new Options trading account

Endpoint

POST

/trading/v1/options/accounts

Base URL: https://api.derivws.com

Request & Response

View Raw

Status Codes

200

OK - Account already exists with the same parameters

{
  "data": {
    "account_id": "DOT90004580",
    "balance": 10000,
    "currency": "USD",
    "group": "row",
    "status": "active",
    "account_type": "demo"
  },
  "meta": {
    "endpoint": "/accounts",
    "method": "POST",
    "timing": 245
  }
}

201

Created - New account successfully created

{
  "data": [
    {
      "account_id": "DOT90004580",
      "balance": 10000,
      "currency": "USD",
      "group": "row",
      "status": "active",
      "account_type": "demo"
    }
  ],
  "meta": {
    "endpoint": "/accounts",
    "method": "POST",
    "timing": 456
  }
}

400

Bad request - Invalid or missing parameters

500

Internal server error

Error Responses

The API returns structured error responses with detailed information about what went wrong.

400

Bad request

{
  "errors": [
    {
      "status": 400,
      "code": "FieldIsRequired",
      "message": "currency field is required"
    }
  ],
  "meta": {
    "endpoint": "/accounts",
    "method": "POST",
    "timing": 23
  }
}

500

Internal server error

{
  "errors": [
    {
      "status": 500,
      "code": "InternalError",
      "message": "An internal error occurred"
    }
  ],
  "meta": {
    "endpoint": "/accounts",
    "method": "POST",
    "timing": 67
  }
}

Authentication Required

This endpoint requires the Deriv-App-ID header to identify your application.

OAuth2 Scope: admin

About create_account

The create_account endpoint create a new options trading account

Response Status Codes

200 OK: Returned when an account with the same parameters already exists. The response contains a single account object in the data field.

201 Created: Returned when a new account is successfully created. The response contains an array of accounts in the data field.

Account Types

Demo Account: Practice trading with virtual funds. Perfect for testing and learning.
Real Account: Trade with real money. Requires proper verification and funding.

Currency Support

Currently, Options accounts support USD currency. More currencies may be added in the future.

Request Parameters

All fields are required:

currency: Must be "USD"
group: Must be "row"
account_type: Either "demo" or "real"