Skip to main content

API Key & Host Setup

Create an API key in Key Management, store the secret safely, and copy the current host from the DNS widget before making signed requests.

Where this lives in the client UI

Create credentials in Key Management and copy the current host shown by the DNS widget before sending signed requests.

Credentials

API Key

Create an API key and copy the public key plus secret key.

Connectivity

DNS host widget

Show the current host value that this client should use for API requests. After DMS, this may be dynamic per client, region, account context, or connectivity route.

Scope

Trading account

Select the trading account or account group that the key can access.

Key Management flow

  1. 1
    Log in to Personal Area or the client portal.
  2. 2
    Open Key Management.
  3. 3
    Create a new API key.
  4. 4
    Select the key type when supported by the product UI.
  5. 5
    Fill in the key name, expiry date, trading account, and allowed IPs if these fields are enabled.
  6. 6
    Copy and securely store the API key and secret key. The secret should be shown only once.
  7. 7
    Copy the host from the DNS widget or continue to Access Point / Host Discovery if your integration resolves host values programmatically.

Values to store

ValueWhere it comes fromClient use
EXN_API_KEYKey ManagementIdentifies the API key in signed requests.
EXN_PRIVATE_KEYKey Management secretUsed locally by the client to create request signatures.
EXN_ACCOUNT_IDSelected trading accountUsed in account-scoped endpoints.
EXN_API_BASE_URLDNS widget or host discoveryBase URL for API requests.

Current review hosts

Use the host displayed in Key Management or returned by host discovery. Current configured static hosts are:

HostStatusClient action
https://api.exness.comMainUse as the primary review/prototype host unless the client portal shows a different value.
https://api.exness-api.comAlternativeUse only when documented or displayed as the correct host for the client.

Example

Store generated values locally as environment variables. These values are placeholders.

export EXN_API_KEY="exnsk_your_public_api_key"
export EXN_PRIVATE_KEY="your_private_secret_key"
export EXN_ACCOUNT_ID="123456"
export EXN_API_BASE_URL="https://api.exness.com"
Do not create API keys through the Exness API.

Use Key Management for API key creation, host visibility, revocation, and rotation.

Security rules

  • Store the secret key securely.
  • Do not commit it to Git, paste it into chats, hardcode it in production, or include it in screenshots.
  • If the secret key is lost, create a new API key.
  • If the secret key is leaked, revoke the API key and create a new one.
  • Use allowed IPs when the product UI supports IP restrictions.