Which API should I use?

  • Use v20 REST API only if you have a v20 account
  • Use v1 REST API if your account id contains only digits (ie. 2534253) as it is a legacy account

Account Endpoints


Request

Name Located In Type Description
Authorization header string The authorization bearer token previously obtained by the client [required]

Responses

Response Body Schema (application/json)

{
    # 
    # The list of Accounts the client is authorized to access and their
    # associated properties.
    # 
    accounts : (Array[AccountProperties])
}

Other Error Responses: 401, 405

Examples

Request
curl \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <TOKEN>" \
  "<URL>/v3/accounts"
Response Headers
HTTP/1.1 200 OK
Access-Control-Allow-Headers: Authorization, Content-Type, Accept-Datetime-Format
Content-Encoding: gzip
Transfer-Encoding: chunked
Server: openresty/1.7.0.1
Connection: keep-alive
Date: Wed, 22 Jun 2016 18:32:01 GMT
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: PUT, PATCH, POST, GET, OPTIONS, DELETE
Content-Type: application/json; charset=UTF-8
Response Body
{
  "accounts": [
    {
      "id": "<ACCOUNT>", 
      "tags": []
    }
  ]
}

Request

Name Located In Type Description
Authorization header string The authorization bearer token previously obtained by the client [required]
Accept-Datetime-Format header AcceptDatetimeFormat Format of DateTime fields in the request and response.
accountID path AccountID Account Identifier [required]

Responses

Response Body Schema (application/json)

{
    # 
    # The full details of the requested Account.
    # 
    account : (Account),

    # 
    # The ID of the most recent Transaction created for the Account.
    # 
    lastTransactionID : (TransactionID)
}

Other Error Responses: 400, 401, 405

Examples

Request
curl \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <TOKEN>" \
  "<URL>/v3/accounts/<ACCOUNT>"
Response Headers
HTTP/1.1 200 OK
Access-Control-Allow-Headers: Authorization, Content-Type, Accept-Datetime-Format
Content-Encoding: gzip
Transfer-Encoding: chunked
Server: openresty/1.7.0.1
Connection: keep-alive
Date: Wed, 22 Jun 2016 18:32:01 GMT
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: PUT, PATCH, POST, GET, OPTIONS, DELETE
Content-Type: application/json
Response Body
{
  "account": {
    "NAV": "43650.78835", 
    "alias": "My New Account #2", 
    "balance": "43650.78835", 
    "createdByUserID": <USERID>, 
    "createdTime": "2015-08-12T18:21:00.697504698Z", 
    "currency": "CHF", 
    "hedgingEnabled": false, 
    "id": "<ACCOUNT>", 
    "lastTransactionID": "6356", 
    "marginAvailable": "43650.78835", 
    "marginCloseoutMarginUsed": "0.00000", 
    "marginCloseoutNAV": "43650.78835", 
    "marginCloseoutPercent": "0.00000", 
    "marginCloseoutPositionValue": "0.00000", 
    "marginCloseoutUnrealizedPL": "0.00000", 
    "marginRate": "0.02", 
    "marginUsed": "0.00000", 
    "openPositionCount": 0, 
    "openTradeCount": 0, 
    "orders": [], 
    "pendingOrderCount": 0, 
    "pl": "-56034.41199", 
    "positionValue": "0.00000", 
    "positions": [
      {
        "instrument": "EUR_USD", 
        "long": {
          "pl": "-54344.82371", 
          "resettablePL": "-54344.82371", 
          "units": "0", 
          "unrealizedPL": "0.00000"
        }, 
        "pl": "-54300.41484", 
        "resettablePL": "-54300.41484", 
        "short": {
          "pl": "44.40887", 
          "resettablePL": "44.40887", 
          "units": "0", 
          "unrealizedPL": "0.00000"
        }, 
        "unrealizedPL": "0.00000"
      }, 
      {
        "instrument": "EUR_GBP", 
        "long": {
          "pl": "-21.81721", 
          "resettablePL": "-21.81721", 
          "units": "0", 
          "unrealizedPL": "0.00000"
        }, 
        "pl": "-21.81721", 
        "resettablePL": "-21.81721", 
        "short": {
          "pl": "0.00000", 
          "resettablePL": "0.00000", 
          "units": "0", 
          "unrealizedPL": "0.00000"
        }, 
        "unrealizedPL": "0.00000"
      }, 
      {
        "instrument": "EUR_CAD", 
        "long": {
          "pl": "0.35963", 
          "resettablePL": "0.35963", 
          "units": "0", 
          "unrealizedPL": "0.00000"
        }, 
        "pl": "0.35963", 
        "resettablePL": "0.35963", 
        "short": {
          "pl": "0.00000", 
          "resettablePL": "0.00000", 
          "units": "0", 
          "unrealizedPL": "0.00000"
        }, 
        "unrealizedPL": "0.00000"
      }, 
      {
        "instrument": "EUR_CHF", 
        "long": {
          "pl": "-868.95147", 
          "resettablePL": "-868.95147", 
          "units": "0", 
          "unrealizedPL": "0.00000"
        }, 
        "pl": "-868.95147", 
        "resettablePL": "-868.95147", 
        "short": {
          "pl": "0.00000", 
          "resettablePL": "0.00000", 
          "units": "0", 
          "unrealizedPL": "0.00000"
        }, 
        "unrealizedPL": "0.00000"
      }, 
      {
        "instrument": "EUR_CZK", 
        "long": {
          "pl": "-0.11620", 
          "resettablePL": "-0.11620", 
          "units": "0", 
          "unrealizedPL": "0.00000"
        }, 
        "pl": "-0.11620", 
        "resettablePL": "-0.11620", 
        "short": {
          "pl": "0.00000", 
          "resettablePL": "0.00000", 
          "units": "0", 
          "unrealizedPL": "0.00000"
        }, 
        "unrealizedPL": "0.00000"
      }, 
      {
        "instrument": "USD_CAD", 
        "long": {
          "pl": "-483.91941", 
          "resettablePL": "-483.91941", 
          "units": "0", 
          "unrealizedPL": "0.00000"
        }, 
        "pl": "-486.15018", 
        "resettablePL": "-486.15018", 
        "short": {
          "pl": "-2.23077", 
          "resettablePL": "-2.23077", 
          "units": "0", 
          "unrealizedPL": "0.00000"
        }, 
        "unrealizedPL": "0.00000"
      }, 
      {
        "instrument": "USD_JPY", 
        "long": {
          "pl": "-20.20008", 
          "resettablePL": "-20.20008", 
          "units": "0", 
          "unrealizedPL": "0.00000"
        }, 
        "pl": "-20.20008", 
        "resettablePL": "-20.20008", 
        "short": {
          "pl": "0.00000", 
          "resettablePL": "0.00000", 
          "units": "0", 
          "unrealizedPL": "0.00000"
        }, 
        "unrealizedPL": "0.00000"
      }, 
      {
        "instrument": "USD_DKK", 
        "long": {
          "pl": "-84.23588", 
          "resettablePL": "-84.23588", 
          "units": "0", 
          "unrealizedPL": "0.00000"
        }, 
        "pl": "-84.23588", 
        "resettablePL": "-84.23588", 
        "short": {
          "pl": "0.00000", 
          "resettablePL": "0.00000", 
          "units": "0", 
          "unrealizedPL": "0.00000"
        }, 
        "unrealizedPL": "0.00000"
      }, 
      {
        "instrument": "GBP_CHF", 
        "long": {
          "pl": "-17.36306", 
          "resettablePL": "-17.36306", 
          "units": "0", 
          "unrealizedPL": "0.00000"
        }, 
        "pl": "-17.36306", 
        "resettablePL": "-17.36306", 
        "short": {
          "pl": "0.00000", 
          "resettablePL": "0.00000", 
          "units": "0", 
          "unrealizedPL": "0.00000"
        }, 
        "unrealizedPL": "0.00000"
      }, 
      {
        "instrument": "GBP_JPY", 
        "long": {
          "pl": "-0.32444", 
          "resettablePL": "-0.32444", 
          "units": "0", 
          "unrealizedPL": "0.00000"
        }, 
        "pl": "-0.32444", 
        "resettablePL": "-0.32444", 
        "short": {
          "pl": "0.00000", 
          "resettablePL": "0.00000", 
          "units": "0", 
          "unrealizedPL": "0.00000"
        }, 
        "unrealizedPL": "0.00000"
      }, 
      {
        "instrument": "AUD_USD", 
        "long": {
          "pl": "-2.31173", 
          "resettablePL": "-2.31173", 
          "units": "0", 
          "unrealizedPL": "0.00000"
        }, 
        "pl": "-2.31173", 
        "resettablePL": "-2.31173", 
        "short": {
          "pl": "0.00000", 
          "resettablePL": "0.00000", 
          "units": "0", 
          "unrealizedPL": "0.00000"
        }, 
        "unrealizedPL": "0.00000"
      }, 
      {
        "instrument": "AUD_JPY", 
        "long": {
          "pl": "-230.54045", 
          "resettablePL": "-230.54045", 
          "units": "0", 
          "unrealizedPL": "0.00000"
        }, 
        "pl": "-230.54045", 
        "resettablePL": "-230.54045", 
        "short": {
          "pl": "0.00000", 
          "resettablePL": "0.00000", 
          "units": "0", 
          "unrealizedPL": "0.00000"
        }, 
        "unrealizedPL": "0.00000"
      }, 
      {
        "instrument": "CHF_JPY", 
        "long": {
          "pl": "-2.34608", 
          "resettablePL": "-2.34608", 
          "units": "0", 
          "unrealizedPL": "0.00000"
        }, 
        "pl": "-2.34608", 
        "resettablePL": "-2.34608", 
        "short": {
          "pl": "0.00000", 
          "resettablePL": "0.00000", 
          "units": "0", 
          "unrealizedPL": "0.00000"
        }, 
        "unrealizedPL": "0.00000"
      }
    ], 
    "resettablePL": "-56034.41199", 
    "trades": [], 
    "unrealizedPL": "0.00000", 
    "withdrawalLimit": "43650.78835"
  }, 
  "lastTransactionID": "6356"
}

Request

Name Located In Type Description
Authorization header string The authorization bearer token previously obtained by the client [required]
Accept-Datetime-Format header AcceptDatetimeFormat Format of DateTime fields in the request and response.
accountID path AccountID Account Identifier [required]

Responses

Response Body Schema (application/json)

{
    # 
    # The summary of the requested Account.
    # 
    account : (AccountSummary),

    # 
    # The ID of the most recent Transaction created for the Account.
    # 
    lastTransactionID : (TransactionID)
}

Other Error Responses: 400, 401, 405

Examples

Request
curl \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <TOKEN>" \
  "<URL>/v3/accounts/<ACCOUNT>/summary"
Response Headers
HTTP/1.1 200 OK
Access-Control-Allow-Headers: Authorization, Content-Type, Accept-Datetime-Format
Content-Encoding: gzip
Transfer-Encoding: chunked
Server: openresty/1.7.0.1
Connection: keep-alive
Date: Wed, 22 Jun 2016 18:32:01 GMT
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: PUT, PATCH, POST, GET, OPTIONS, DELETE
Content-Type: application/json
Response Body
{
  "account": {
    "NAV": "43650.78835", 
    "alias": "My New Account #2", 
    "balance": "43650.78835", 
    "createdByUserID": <USERID>, 
    "createdTime": "2015-08-12T18:21:00.697504698Z", 
    "currency": "CHF", 
    "hedgingEnabled": false, 
    "id": "<ACCOUNT>", 
    "lastTransactionID": "6356", 
    "marginAvailable": "43650.78835", 
    "marginCloseoutMarginUsed": "0.00000", 
    "marginCloseoutNAV": "43650.78835", 
    "marginCloseoutPercent": "0.00000", 
    "marginCloseoutPositionValue": "0.00000", 
    "marginCloseoutUnrealizedPL": "0.00000", 
    "marginRate": "0.02", 
    "marginUsed": "0.00000", 
    "openPositionCount": 0, 
    "openTradeCount": 0, 
    "pendingOrderCount": 0, 
    "pl": "-56034.41199", 
    "positionValue": "0.00000", 
    "resettablePL": "-56034.41199", 
    "unrealizedPL": "0.00000", 
    "withdrawalLimit": "43650.78835"
  }, 
  "lastTransactionID": "6356"
}

Request

Name Located In Type Description
Authorization header string The authorization bearer token previously obtained by the client [required]
accountID path AccountID Account Identifier [required]
instruments query List of InstrumentName (csv) List of instruments to query specifically.

Responses

Response Body Schema (application/json)

{
    # 
    # The requested list of instruments.
    # 
    instruments : (Array[Instrument]),

    # 
    # The ID of the most recent Transaction created for the Account.
    # 
    lastTransactionID : (TransactionID)
}

Other Error Responses: 400, 401, 405

Examples

Request
curl \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <TOKEN>" \
  "<URL>/v3/accounts/<ACCOUNT>/instruments"
Response Headers
HTTP/1.1 200 OK
Access-Control-Allow-Headers: Authorization, Content-Type, Accept-Datetime-Format
Content-Encoding: gzip
Transfer-Encoding: chunked
Server: openresty/1.7.0.1
Connection: keep-alive
Date: Wed, 22 Jun 2016 18:32:01 GMT
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: PUT, PATCH, POST, GET, OPTIONS, DELETE
Content-Type: application/json
Response Body
{
  "instruments": [
    {
      "displayName": "USD/THB", 
      "displayPrecision": 3, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "100.000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.050", 
      "name": "USD_THB", 
      "pipLocation": -2, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "GBP/CHF", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "GBP_CHF", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "EUR/GBP", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "EUR_GBP", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "EUR/JPY", 
      "displayPrecision": 3, 
      "marginRate": "0.03", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "100.000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.050", 
      "name": "EUR_JPY", 
      "pipLocation": -2, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "EUR/SGD", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "EUR_SGD", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "CAD/JPY", 
      "displayPrecision": 3, 
      "marginRate": "0.03", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "100.000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.050", 
      "name": "CAD_JPY", 
      "pipLocation": -2, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "GBP/ZAR", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "GBP_ZAR", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "EUR/CHF", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "EUR_CHF", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "SGD/CHF", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "SGD_CHF", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "CHF/ZAR", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "CHF_ZAR", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "SGD/JPY", 
      "displayPrecision": 3, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "100.000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.050", 
      "name": "SGD_JPY", 
      "pipLocation": -2, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "NZD/USD", 
      "displayPrecision": 5, 
      "marginRate": "0.02", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "NZD_USD", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "NZD/CHF", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "NZD_CHF", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "EUR/HKD", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "EUR_HKD", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "USD/HKD", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "USD_HKD", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "USD/DKK", 
      "displayPrecision": 5, 
      "marginRate": "0.02", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "USD_DKK", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "AUD/HKD", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "AUD_HKD", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "EUR/CZK", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "EUR_CZK", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "EUR/NOK", 
      "displayPrecision": 5, 
      "marginRate": "0.03", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "EUR_NOK", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "NZD/JPY", 
      "displayPrecision": 3, 
      "marginRate": "0.03", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "100.000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.050", 
      "name": "NZD_JPY", 
      "pipLocation": -2, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "AUD/USD", 
      "displayPrecision": 5, 
      "marginRate": "0.03", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "AUD_USD", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "AUD/NZD", 
      "displayPrecision": 5, 
      "marginRate": "0.03", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "AUD_NZD", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "EUR/CAD", 
      "displayPrecision": 5, 
      "marginRate": "0.02", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "EUR_CAD", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "GBP/PLN", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "GBP_PLN", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "ZAR/JPY", 
      "displayPrecision": 3, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "100.000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.050", 
      "name": "ZAR_JPY", 
      "pipLocation": -2, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "USD/SAR", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "USD_SAR", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "GBP/CAD", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "GBP_CAD", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "AUD/JPY", 
      "displayPrecision": 3, 
      "marginRate": "0.03", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "100.000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.050", 
      "name": "AUD_JPY", 
      "pipLocation": -2, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "GBP/JPY", 
      "displayPrecision": 3, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "100.000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.050", 
      "name": "GBP_JPY", 
      "pipLocation": -2, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "USD/TRY", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "USD_TRY", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "EUR/NZD", 
      "displayPrecision": 5, 
      "marginRate": "0.02", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "EUR_NZD", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "EUR/ZAR", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "EUR_ZAR", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "GBP/USD", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "GBP_USD", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "USD/MXN", 
      "displayPrecision": 5, 
      "marginRate": "0.06", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "USD_MXN", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "EUR/PLN", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "EUR_PLN", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "EUR/DKK", 
      "displayPrecision": 5, 
      "marginRate": "0.02", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "EUR_DKK", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "USD/NOK", 
      "displayPrecision": 5, 
      "marginRate": "0.03", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "USD_NOK", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "USD/CZK", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "USD_CZK", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "NZD/SGD", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "NZD_SGD", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "USD/HUF", 
      "displayPrecision": 3, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "100.000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.050", 
      "name": "USD_HUF", 
      "pipLocation": -2, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "GBP/HKD", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "GBP_HKD", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "USD/SEK", 
      "displayPrecision": 5, 
      "marginRate": "0.03", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "USD_SEK", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "GBP/SGD", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "GBP_SGD", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "AUD/CHF", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "AUD_CHF", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "AUD/SGD", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "AUD_SGD", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "USD/CNH", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "USD_CNH", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "TRY/JPY", 
      "displayPrecision": 3, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "100.000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.050", 
      "name": "TRY_JPY", 
      "pipLocation": -2, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "AUD/CAD", 
      "displayPrecision": 5, 
      "marginRate": "0.03", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "AUD_CAD", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "CAD/HKD", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "CAD_HKD", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "SGD/HKD", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "SGD_HKD", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "GBP/NZD", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "GBP_NZD", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "NZD/CAD", 
      "displayPrecision": 5, 
      "marginRate": "0.02", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "NZD_CAD", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "USD/ZAR", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "USD_ZAR", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "EUR/SEK", 
      "displayPrecision": 5, 
      "marginRate": "0.03", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "EUR_SEK", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "USD/SGD", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "USD_SGD", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "HKD/JPY", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "HKD_JPY", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "EUR/USD", 
      "displayPrecision": 5, 
      "marginRate": "0.02", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "EUR_USD", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "GBP/AUD", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "GBP_AUD", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "USD/PLN", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "USD_PLN", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "USD/CAD", 
      "displayPrecision": 5, 
      "marginRate": "0.02", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "USD_CAD", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "CAD/SGD", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "CAD_SGD", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "CHF/HKD", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "CHF_HKD", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "USD/CHF", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "USD_CHF", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "NZD/HKD", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "NZD_HKD", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "EUR/AUD", 
      "displayPrecision": 5, 
      "marginRate": "0.03", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "EUR_AUD", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "CAD/CHF", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "CAD_CHF", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "CHF/JPY", 
      "displayPrecision": 3, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "100.000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.050", 
      "name": "CHF_JPY", 
      "pipLocation": -2, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "USD/JPY", 
      "displayPrecision": 3, 
      "marginRate": "0.03", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "100.000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.050", 
      "name": "USD_JPY", 
      "pipLocation": -2, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "EUR/TRY", 
      "displayPrecision": 5, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "EUR_TRY", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }, 
    {
      "displayName": "EUR/HUF", 
      "displayPrecision": 3, 
      "marginRate": "0.05", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "100.000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.050", 
      "name": "EUR_HUF", 
      "pipLocation": -2, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }
  ], 
  "lastTransactionID": "6356"
}
Request
curl \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <TOKEN>" \
  "<URL>/v3/accounts/<ACCOUNT>/instruments?instruments=EUR_USD"
Response Headers
HTTP/1.1 200 OK
Access-Control-Allow-Headers: Authorization, Content-Type, Accept-Datetime-Format
Content-Encoding: gzip
Transfer-Encoding: chunked
Server: openresty/1.7.0.1
Connection: keep-alive
Date: Wed, 22 Jun 2016 18:32:01 GMT
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: PUT, PATCH, POST, GET, OPTIONS, DELETE
Content-Type: application/json
Response Body
{
  "instruments": [
    {
      "displayName": "EUR/USD", 
      "displayPrecision": 5, 
      "marginRate": "0.02", 
      "maximumOrderUnits": "100000000", 
      "maximumPositionSize": "0", 
      "maximumTrailingStopDistance": "1.00000", 
      "minimumTradeSize": "1", 
      "minimumTrailingStopDistance": "0.00050", 
      "name": "EUR_USD", 
      "pipLocation": -4, 
      "tradeUnitsPrecision": 0, 
      "type": "CURRENCY"
    }
  ], 
  "lastTransactionID": "6356"
}

Request

Name Located In Type Description
Authorization header string The authorization bearer token previously obtained by the client [required]
Accept-Datetime-Format header AcceptDatetimeFormat Format of DateTime fields in the request and response.
accountID path AccountID Account Identifier [required]
Request Body Schema (application/json)

{
    # 
    # Client-defined alias (name) for the Account
    # 
    alias : (string),

    # 
    # The string representation of a decimal number.
    # 
    marginRate : (DecimalNumber)
}

Responses

Response Body Schema (application/json)

{
    # 
    # The transaction that configures the Account.
    # 
    clientConfigureTransaction : (ClientConfigureTransaction),

    # 
    # The ID of the last Transaction created for the Account.
    # 
    lastTransactionID : (TransactionID)
}
Response Body Schema (application/json)

{
    # 
    # The transaction that rejects the configuration of the Account.
    # 
    clientConfigureRejectTransaction : (ClientConfigureRejectTransaction),

    # 
    # The ID of the last Transaction created for the Account.
    # 
    lastTransactionID : (TransactionID),

    # 
    # The code of the error that has occurred. This field may not be returned
    # for some errors.
    # 
    errorCode : (string),

    # 
    # The human-readable description of the error that has occurred.
    # 
    errorMessage : (string, required)
}
Response Body Schema (application/json)

{
    # 
    # The transaction that rejects the configuration of the Account.
    # 
    clientConfigureRejectTransaction : (ClientConfigureRejectTransaction),

    # 
    # The ID of the last Transaction created for the Account.
    # 
    lastTransactionID : (TransactionID),

    # 
    # The code of the error that has occurred. This field may not be returned
    # for some errors.
    # 
    errorCode : (string),

    # 
    # The human-readable description of the error that has occurred.
    # 
    errorMessage : (string, required)
}

Other Error Responses: 401, 404, 405

Examples

Request
body=$(cat << EOF
{
  "marginRate": "0.02"
}
EOF
)

curl \
  -X PATCH \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <TOKEN>" \
  -d "$body" \
  "<URL>/v3/accounts/<ACCOUNT>/configuration"
Response Headers
HTTP/1.1 200 OK
Access-Control-Allow-Headers: Authorization, Content-Type, Accept-Datetime-Format
Content-Encoding: gzip
Transfer-Encoding: chunked
Server: openresty/1.7.0.1
Connection: keep-alive
Location: <URL>/v3/accounts/<ACCOUNT>
Date: Wed, 22 Jun 2016 18:32:01 GMT
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: PUT, PATCH, POST, GET, OPTIONS, DELETE
Content-Type: application/json
Response Body
{
  "clientConfigureTransaction": {
    "accountID": "<ACCOUNT>", 
    "batchID": "6357", 
    "id": "6357", 
    "marginRate": "0.02", 
    "time": "2016-06-22T18:32:01.336826542Z", 
    "type": "CLIENT_CONFIGURE", 
    "userID": <USERID>
  }, 
  "lastTransactionID": "6357"
}
Request
body=$(cat << EOF
{
  "alias": "My New Account #2"
}
EOF
)

curl \
  -X PATCH \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <TOKEN>" \
  -d "$body" \
  "<URL>/v3/accounts/<ACCOUNT>/configuration"
Response Headers
HTTP/1.1 200 OK
Access-Control-Allow-Headers: Authorization, Content-Type, Accept-Datetime-Format
Content-Encoding: gzip
Transfer-Encoding: chunked
Server: openresty/1.7.0.1
Connection: keep-alive
Location: <URL>/v3/accounts/<ACCOUNT>
Date: Wed, 22 Jun 2016 18:32:01 GMT
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: PUT, PATCH, POST, GET, OPTIONS, DELETE
Content-Type: application/json
Response Body
{
  "clientConfigureTransaction": {
    "accountID": "<ACCOUNT>", 
    "alias": "My New Account #2", 
    "batchID": "6358", 
    "id": "6358", 
    "time": "2016-06-22T18:32:01.340732541Z", 
    "type": "CLIENT_CONFIGURE", 
    "userID": <USERID>
  }, 
  "lastTransactionID": "6358"
}

Request

Name Located In Type Description
Authorization header string The authorization bearer token previously obtained by the client [required]
Accept-Datetime-Format header AcceptDatetimeFormat Format of DateTime fields in the request and response.
accountID path AccountID Account Identifier [required]
sinceTransactionID query TransactionID ID of the Transaction to get Account changes since.

Responses

Response Body Schema (application/json)

{
    # 
    # The changes to the Account’s Orders, Trades and Positions since the
    # specified Transaction ID. Only provided if the sinceTransactionID is
    # supplied to the poll request.
    # 
    changes : (AccountChanges),

    # 
    # The Account’s current price-dependent state.
    # 
    state : (AccountChangesState),

    # 
    # The ID of the last Transaction created for the Account.  This Transaction
    # ID should be used for future poll requests, as the client has already
    # observed all changes up to and including it.
    # 
    lastTransactionID : (TransactionID)
}

Other Error Responses: 401, 404, 405, 416

Examples

Request
curl \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <TOKEN>" \
  "<URL>/v3/accounts/<ACCOUNT>/changes?sinceTransactionID=6358"
Response Headers
HTTP/1.1 200 OK
Access-Control-Allow-Headers: Authorization, Content-Type, Accept-Datetime-Format
Content-Encoding: gzip
Transfer-Encoding: chunked
Server: openresty/1.7.0.1
Connection: keep-alive
Date: Wed, 22 Jun 2016 18:32:01 GMT
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: PUT, PATCH, POST, GET, OPTIONS, DELETE
Content-Type: application/json
Response Body
{
  "changes": {
    "ordersCancelled": [], 
    "ordersCreated": [], 
    "ordersFilled": [
      {
        "createTime": "2016-06-22T18:32:01.344836338Z", 
        "filledTime": "2016-06-22T18:32:01.344836338Z", 
        "fillingTransactionID": "6360", 
        "id": "6359", 
        "instrument": "USD_CAD", 
        "positionFill": "POSITION_DEFAULT", 
        "state": "FILLED", 
        "timeInForce": "FOK", 
        "tradeOpenedID": "6360", 
        "type": "MARKET", 
        "units": "-100"
      }, 
      {
        "createTime": "2016-06-22T18:32:01.350319712Z", 
        "filledTime": "2016-06-22T18:32:01.350319712Z", 
        "fillingTransactionID": "6362", 
        "id": "6361", 
        "instrument": "EUR_USD", 
        "positionFill": "POSITION_DEFAULT", 
        "state": "FILLED", 
        "timeInForce": "FOK", 
        "tradeOpenedID": "6362", 
        "type": "MARKET", 
        "units": "100"
      }
    ], 
    "ordersTriggered": [], 
    "positions": [
      {
        "instrument": "USD_CAD", 
        "long": {
          "pl": "-483.91941", 
          "resettablePL": "-483.91941", 
          "units": "0"
        }, 
        "pl": "-486.15018", 
        "resettablePL": "-486.15018", 
        "short": {
          "averagePrice": "1.28324", 
          "pl": "-2.23077", 
          "resettablePL": "-2.23077", 
          "tradeIDs": [
            "6360"
          ], 
          "units": "-100"
        }
      }, 
      {
        "instrument": "EUR_USD", 
        "long": {
          "averagePrice": "1.13067", 
          "pl": "-54344.82371", 
          "resettablePL": "-54344.82371", 
          "tradeIDs": [
            "6362"
          ], 
          "units": "100"
        }, 
        "pl": "-54300.41484", 
        "resettablePL": "-54300.41484", 
        "short": {
          "pl": "44.40887", 
          "resettablePL": "44.40887", 
          "units": "0"
        }
      }
    ], 
    "tradesClosed": [], 
    "tradesOpened": [
      {
        "currentUnits": "100", 
        "financing": "0.00000", 
        "id": "6362", 
        "initialUnits": "100", 
        "instrument": "EUR_USD", 
        "openTime": "2016-06-22T18:32:01.350319712Z", 
        "price": "1.13067", 
        "realizedPL": "0.00000", 
        "state": "OPEN"
      }, 
      {
        "currentUnits": "-100", 
        "financing": "0.00000", 
        "id": "6360", 
        "initialUnits": "-100", 
        "instrument": "USD_CAD", 
        "openTime": "2016-06-22T18:32:01.344836338Z", 
        "price": "1.28324", 
        "realizedPL": "0.00000", 
        "state": "OPEN"
      }
    ], 
    "tradesReduced": [], 
    "transactions": [
      {
        "accountID": "<ACCOUNT>", 
        "batchID": "6359", 
        "id": "6359", 
        "instrument": "USD_CAD", 
        "positionFill": "DEFAULT", 
        "reason": "CLIENT_ORDER", 
        "time": "2016-06-22T18:32:01.344836338Z", 
        "timeInForce": "FOK", 
        "type": "MARKET_ORDER", 
        "units": "-100", 
        "userID": <USERID>
      }, 
      {
        "accountBalance": "43650.78835", 
        "accountID": "<ACCOUNT>", 
        "batchID": "6359", 
        "financing": "0.00000", 
        "id": "6360", 
        "instrument": "USD_CAD", 
        "orderID": "6359", 
        "pl": "0.00000", 
        "price": "1.28324", 
        "reason": "MARKET_ORDER", 
        "time": "2016-06-22T18:32:01.344836338Z", 
        "tradeOpened": {
          "tradeID": "6360", 
          "units": "-100"
        }, 
        "type": "ORDER_FILL", 
        "units": "-100", 
        "userID": <USERID>
      }, 
      {
        "accountID": "<ACCOUNT>", 
        "batchID": "6361", 
        "id": "6361", 
        "instrument": "EUR_USD", 
        "positionFill": "DEFAULT", 
        "reason": "CLIENT_ORDER", 
        "time": "2016-06-22T18:32:01.350319712Z", 
        "timeInForce": "FOK", 
        "type": "MARKET_ORDER", 
        "units": "100", 
        "userID": <USERID>
      }, 
      {
        "accountBalance": "43650.78835", 
        "accountID": "<ACCOUNT>", 
        "batchID": "6361", 
        "financing": "0.00000", 
        "id": "6362", 
        "instrument": "EUR_USD", 
        "orderID": "6361", 
        "pl": "0.00000", 
        "price": "1.13067", 
        "reason": "MARKET_ORDER", 
        "time": "2016-06-22T18:32:01.350319712Z", 
        "tradeOpened": {
          "tradeID": "6362", 
          "units": "100"
        }, 
        "type": "ORDER_FILL", 
        "units": "100", 
        "userID": <USERID>
      }
    ]
  }, 
  "lastTransactionID": "6362", 
  "state": {
    "NAV": "43650.75945", 
    "marginAvailable": "43646.67432", 
    "marginCloseoutMarginUsed": "4.08531", 
    "marginCloseoutNAV": "43650.77342", 
    "marginCloseoutPercent": "0.00005", 
    "marginCloseoutUnrealizedPL": "-0.01493", 
    "marginUsed": "4.08513", 
    "orders": [], 
    "positionValue": "204.25656", 
    "positions": [
      {
        "instrument": "EUR_USD", 
        "longUnrealizedPL": "-0.01246", 
        "netUnrealizedPL": "-0.01246", 
        "shortUnrealizedPL": "0.00000"
      }, 
      {
        "instrument": "USD_CAD", 
        "longUnrealizedPL": "0.00000", 
        "netUnrealizedPL": "-0.01644", 
        "shortUnrealizedPL": "-0.01644"
      }
    ], 
    "trades": [
      {
        "id": "6362", 
        "unrealizedPL": "-0.01246"
      }, 
      {
        "id": "6360", 
        "unrealizedPL": "-0.01644"
      }
    ], 
    "unrealizedPL": "-0.02890", 
    "withdrawalLimit": "43646.67432"
  }
}