Lumetrade Staging API
POST /api/v1/accounts

Creates an account for the authenticated API key owner only when the requested currency is enabled in the owner's effective jurisdiction.

Headers

  • X-API-KEY string Required

    Public API key issued from the Lumetrade API key management flow.

  • X-API-SECRET string Required

    API secret paired with the public API key.

application/json

Body Required

  • currency string

    Currency code for the account to create.

Responses

  • 201 application/json

    Account created successfully

    Hide response attributes Show response attributes object
    • id string

      Account id used by external account endpoints.

    • currency string

      Account currency.

    • balance number

      Available account balance.

    • lockedBalance number

      Locked account balance.
  • 400 application/json

    Request validation failed

    Hide response attributes Show response attributes object
    • id string

      Account id used by external account endpoints.

    • currency string

      Account currency.

    • balance number

      Available account balance.

    • lockedBalance number

      Locked account balance.
  • 404 application/json

    Currency is not supported for this user

    Hide response attributes Show response attributes object
    • id string

      Account id used by external account endpoints.

    • currency string

      Account currency.

    • balance number

      Available account balance.

    • lockedBalance number

      Locked account balance.
  • 409 application/json

    Account already exists

    Hide response attributes Show response attributes object
    • id string

      Account id used by external account endpoints.

    • currency string

      Account currency.

    • balance number

      Available account balance.

    • lockedBalance number

      Locked account balance.
POST /api/v1/accounts 
curl \
 --request POST 'https://api.lumetrade.com/api/v1/accounts' \
 --header "Content-Type: application/json" \
 --header "X-API-KEY: string" \
 --header "X-API-SECRET: string" \
 --data '{"currency":"ZAR"}'
Request examples 
# Headers
X-API-KEY: string
X-API-SECRET: string

# Payload
{
  "currency": "ZAR"
}
Response examples (201) 
{
  "id": "acc_8F4J2N",
  "currency": "ZAR",
  "balance": 2500,
  "lockedBalance": 0
}
Response examples (400) 
{
  "id": "acc_8F4J2N",
  "currency": "ZAR",
  "balance": 2500,
  "lockedBalance": 0
}
Response examples (404) 
{
  "id": "acc_8F4J2N",
  "currency": "ZAR",
  "balance": 2500,
  "lockedBalance": 0
}
Response examples (409) 
{
  "id": "acc_8F4J2N",
  "currency": "ZAR",
  "balance": 2500,
  "lockedBalance": 0
}