Get account by currency | Lumetrade API documentation

Get account by currency 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

{
  "Lumetrade API MCP server": {
    "url": "https://docs.lumetrade.com/mcp"
  }
}

GET /api/v1/accounts/currency/{currency}

X api key & X api secret

Returns one account belonging to the authenticated API key owner for the requested currency when that currency is enabled in the owner's effective jurisdiction.

Path parameters

currency string Required

Currency for the account lookup.

Responses

200 application/json

Account returned 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.
404 application/json

Account or currency was not found for the authenticated 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.

GET /api/v1/accounts/currency/{currency}

curl \
 --request GET 'https://api.lumetrade.com/api/v1/accounts/currency/ZAR' \
 --header "X-API-KEY: $API_KEY" \
 --header "X-API-SECRET: $API_KEY"

Response examples (200)

{
  "id": "acc_8F4J2N",
  "currency": "ZAR",
  "balance": 2500,
  "lockedBalance": 0
}

Response examples (404)

{
  "id": "acc_8F4J2N",
  "currency": "ZAR",
  "balance": 2500,
  "lockedBalance": 0
}