---
updatedAt: 2026-03-26T12:27:31.000Z
agentTools:
  projectIndex: https://public-api.tradelocker.com/llms.txt
---

# Get instrument details

Get detailed instrument settings, such as lot steps and sizes, quoting currency, trade session id, etc.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "description": "Trading API",
    "version": "2.11.0",
    "title": "Trading API",
    "contact": {}
  },
  "tags": [
    {
      "name": "Instruments and Sessions",
      "description": "Detailed information about instruments and sessions."
    }
  ],
  "paths": {
    "/trade/instruments/{tradableInstrumentId}": {
      "get": {
        "tags": [
          "Instruments and Sessions"
        ],
        "summary": "Get instrument details",
        "description": "Get detailed instrument settings, such as lot steps and sizes, quoting currency, trade session id, etc.",
        "operationId": "getInstrumentDetails",
        "parameters": [
          {
            "name": "tradableInstrumentId",
            "in": "path",
            "description": "Identifier of the instrument that is used for trading purposes.",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "accNum",
            "in": "header",
            "description": "Account number",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "routeId",
            "in": "query",
            "description": "Route identifier",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "locale",
            "in": "query",
            "description": "Locale (language) id.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "ar",
                "en",
                "es",
                "fr",
                "ja",
                "ko",
                "pl",
                "pt",
                "ru",
                "tr",
                "ua",
                "zh_sm",
                "zh_tr"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InstrumentDetailsResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "security": [
          {
            "BearerAuth": []
          }
        ]
      }
    }
  },
  "servers": [
    {
      "url": "https://demo.tradelocker.com/backend-api"
    },
    {
      "url": "https://live.tradelocker.com/backend-api"
    }
  ],
  "components": {
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    },
    "schemas": {
      "InstrumentDetailsResponse": {
        "type": "object",
        "required": [
          "d",
          "s"
        ],
        "properties": {
          "d": {
            "$ref": "#/components/schemas/Instrument_details"
          },
          "s": {
            "type": "string",
            "example": "ok",
            "description": "Status will always be `ok`."
          }
        },
        "title": "InstrumentDetailsResponse"
      },
      "TickCost": {
        "type": "object",
        "properties": {
          "leftRangeLimit": {
            "type": "number",
            "description": "Left end of range."
          },
          "tickCost": {
            "type": "number",
            "description": "Amount of base asset for one tick."
          }
        },
        "title": "TickCost"
      },
      "TickSize": {
        "type": "object",
        "properties": {
          "leftRangeLimit": {
            "type": "number",
            "description": "Left end of range."
          },
          "tickSize": {
            "type": "number",
            "description": "Minimum price change for an instrument."
          }
        },
        "title": "TickSize"
      },
      "Instrument_details": {
        "type": "object",
        "required": [
          "marketDataExchange",
          "name",
          "quotingCurrency",
          "symbolStatus",
          "tradingExchange",
          "type"
        ],
        "properties": {
          "barSource": {
            "type": "string",
            "description": "The principle of building bars. Available values",
            "enum": [
              "ASK",
              "BID",
              "TRADE"
            ]
          },
          "baseCurrency": {
            "type": "string",
            "description": "For currency pairs only. This field contains the first currency of the pair."
          },
          "betSize": {
            "type": "number",
            "description": "The standard bet size for the instrument with spreadbet type in units."
          },
          "betStep": {
            "type": "number",
            "description": "The minimal bet change of quantity in the betting currency. Required for spreadbet type symbols only."
          },
          "bettingCurrency": {
            "type": "string",
            "description": "The currency in which the instrument will be traded. Required for spreadbet type symbols only."
          },
          "contractMonth": {
            "type": "string",
            "format": "date",
            "description": "Final day for delivery."
          },
          "country": {
            "type": "integer",
            "format": "int32",
            "description": "The country for the instrument."
          },
          "deliveryStatus": {
            "type": "string",
            "description": "A contract delivery status.",
            "enum": [
              "DELIVERED",
              "READY_FOR_DELIVERY",
              "WAIT_FOR_PRICE"
            ]
          },
          "description": {
            "type": "string",
            "description": "Any useful information about the instrument."
          },
          "exerciseStyle": {
            "type": "string",
            "description": "Defines the date on which the option may be exercised.",
            "enum": [
              "AMERICAN",
              "EUROPEAN"
            ]
          },
          "firstTradeDate": {
            "type": "string",
            "format": "date",
            "description": "The first day of trading on exchange"
          },
          "hasDaily": {
            "type": "boolean",
            "description": "Boolean value showing whether the symbol includes daily bars historical data."
          },
          "hasIntraday": {
            "type": "boolean",
            "description": "Boolean value showing whether the symbol includes intraday (minutes) historical data."
          },
          "industry": {
            "type": "string",
            "description": "The Industry to which the instrument belongs."
          },
          "isin": {
            "type": "string",
            "description": "The International Securities Identification Number (ISIN) for the instrument."
          },
          "lastTradeDate": {
            "type": "string",
            "format": "date",
            "description": "The last day of trading on exchange. At the end of the session all orders will be\ncanceled and positions will be blocked (a trader won't be able to close them)."
          },
          "leverage": {
            "type": "number",
            "description": "Leverage",
            "example": "100.00"
          },
          "localizedName": {
            "type": "string",
            "description": "The name of the instrument on the specified language in request."
          },
          "logoUrl": {
            "type": "string",
            "description": "URL to get instrument logo."
          },
          "lotSize": {
            "type": "number",
            "description": "The standard lot size for the instrument in units."
          },
          "lotStep": {
            "type": "number",
            "description": "The minimal lot quantity change."
          },
          "margin_hedging_type": {
            "type": "string",
            "description": "Margin hedging type",
            "example": "fx_cfd"
          },
          "marketCap": {
            "type": "number",
            "format": "double",
            "description": "The market capitalization of the Instrument."
          },
          "marketDataExchange": {
            "type": "string",
            "description": "The name of the exchange, which provides market data for the instrument."
          },
          "maxLot": {
            "type": "number",
            "description": "The largest allowed trade quantity in lots."
          },
          "minLot": {
            "type": "number",
            "description": "The smallest allowed trade quantity in lots."
          },
          "name": {
            "type": "string",
            "description": "Name of the instrument."
          },
          "noticeDate": {
            "type": "string",
            "format": "date",
            "description": "The date, when the server will send Futures notice email about the fact that contract\nis going to expire soon."
          },
          "quotingCurrency": {
            "type": "string",
            "description": "Symbol currency, also named as counter currency. If a symbol is a currency pair, then the currency field has to contain the second currency of this pair."
          },
          "sector": {
            "type": "string",
            "description": "The Sector to which the instrument belongs."
          },
          "settlementDate": {
            "type": "string",
            "format": "date",
            "description": "Settlement date of a contract."
          },
          "settlementSystem": {
            "type": "string",
            "description": "The time between the trade date, when an order is executed in the market, and the settlement date.",
            "enum": [
              "Immediate",
              "SPOT",
              "SPOT+1",
              "T+10",
              "T+360",
              "T+4",
              "T+5",
              "TOD",
              "TOM"
            ]
          },
          "strikePrice": {
            "type": "number",
            "description": "Price at which a derivative contract can be bought or sold when it is exercised."
          },
          "strikeType": {
            "type": "string",
            "description": "Put or Call",
            "enum": [
              "CALL",
              "PUT"
            ]
          },
          "symbolStatus": {
            "type": "string",
            "description": "Modes for trading.",
            "enum": [
              "CLOSED",
              "FULLY_OPEN",
              "TRADING_HALT"
            ]
          },
          "tickCost": {
            "type": "array",
            "description": "Amount of base asset for one tick.",
            "items": {
              "$ref": "#/components/schemas/TickCost"
            }
          },
          "tickSize": {
            "type": "array",
            "description": "Minimum price change for an instrument.",
            "items": {
              "$ref": "#/components/schemas/TickSize"
            }
          },
          "tradeSessionId": {
            "type": "integer",
            "format": "int32",
            "description": "Identifier of the instrument trade session"
          },
          "tradeSessionStatusId": {
            "type": "integer",
            "format": "int64",
            "description": "Identifier of the current status of the trade session for the instrument"
          },
          "tradingExchange": {
            "type": "string",
            "description": "The name of the exchange, on which the instrument trade will be performed."
          },
          "type": {
            "type": "string",
            "description": "Symbol type.",
            "enum": [
              "CRYPTO",
              "EQUITY",
              "EQUITY_CFD",
              "ETF",
              "FOREX",
              "FUTURES",
              "FUTURES_CFD",
              "INDICES",
              "OPTIONS",
              "SPREADBET"
            ]
          }
        },
        "title": "Instrument details"
      }
    }
  }
}
```