Create account Run in API Explorer

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://docs.lumetrade.com/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "Lumetrade API MCP server": {
    "url": "https://docs.lumetrade.com/mcp"
  }
}
Close
POST /api/v1/accounts
X api key & X api secret

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

application/json

Body Required

  • currency string

    Currency code for the account to create.

    Minimum length is 0, maximum length is 10.

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 "X-API-KEY: $API_KEY" \
 --header "X-API-SECRET: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{"currency":"ZAR"}'
Request examples 
{
  "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
}