Security Info

curl --request POST \
  --url https://api.dev.tpinf.in/takeprofit.reference.external.security.v1.SecurityInfoApi.ListSecurities \
  --header 'Content-Type: application/json' \
  --data '
{
  "security_ids": [
    {
      "ticker_code": {
        "ticker": "TSLA",
        "exchange_code": "BATS"
      }
    },
    {
      "ticker_code": {
        "ticker": "AAPL",
        "exchange_code": "BATS"
      }
    },
    {
      "ticker_code": {
        "ticker": "ETH/USDT",
        "exchange_code": "CXBNCE"
      }
    },
    {
      "ticker_code": {
        "ticker": "BIT/USD",
        "exchange_code": "CXKRKN"
      }
    },
    {
      "guid": "ca820109-b49a-4835-8422-96698eb65b53"
    }
  ]
}
'

import requests

url = "https://api.dev.tpinf.in/takeprofit.reference.external.security.v1.SecurityInfoApi.ListSecurities"

payload = { "security_ids": [{ "ticker_code": {
                "ticker": "TSLA",
                "exchange_code": "BATS"
            } }, { "ticker_code": {
                "ticker": "AAPL",
                "exchange_code": "BATS"
            } }, { "ticker_code": {
                "ticker": "ETH/USDT",
                "exchange_code": "CXBNCE"
            } }, { "ticker_code": {
                "ticker": "BIT/USD",
                "exchange_code": "CXKRKN"
            } }, { "guid": "ca820109-b49a-4835-8422-96698eb65b53" }] }
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    security_ids: [
      {ticker_code: {ticker: 'TSLA', exchange_code: 'BATS'}},
      {ticker_code: {ticker: 'AAPL', exchange_code: 'BATS'}},
      {ticker_code: {ticker: 'ETH/USDT', exchange_code: 'CXBNCE'}},
      {ticker_code: {ticker: 'BIT/USD', exchange_code: 'CXKRKN'}},
      {guid: 'ca820109-b49a-4835-8422-96698eb65b53'}
    ]
  })
};

fetch('https://api.dev.tpinf.in/takeprofit.reference.external.security.v1.SecurityInfoApi.ListSecurities', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dev.tpinf.in/takeprofit.reference.external.security.v1.SecurityInfoApi.ListSecurities",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'security_ids' => [
        [
                'ticker_code' => [
                                'ticker' => 'TSLA',
                                'exchange_code' => 'BATS'
                ]
        ],
        [
                'ticker_code' => [
                                'ticker' => 'AAPL',
                                'exchange_code' => 'BATS'
                ]
        ],
        [
                'ticker_code' => [
                                'ticker' => 'ETH/USDT',
                                'exchange_code' => 'CXBNCE'
                ]
        ],
        [
                'ticker_code' => [
                                'ticker' => 'BIT/USD',
                                'exchange_code' => 'CXKRKN'
                ]
        ],
        [
                'guid' => 'ca820109-b49a-4835-8422-96698eb65b53'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dev.tpinf.in/takeprofit.reference.external.security.v1.SecurityInfoApi.ListSecurities"

	payload := strings.NewReader("{\n  \"security_ids\": [\n    {\n      \"ticker_code\": {\n        \"ticker\": \"TSLA\",\n        \"exchange_code\": \"BATS\"\n      }\n    },\n    {\n      \"ticker_code\": {\n        \"ticker\": \"AAPL\",\n        \"exchange_code\": \"BATS\"\n      }\n    },\n    {\n      \"ticker_code\": {\n        \"ticker\": \"ETH/USDT\",\n        \"exchange_code\": \"CXBNCE\"\n      }\n    },\n    {\n      \"ticker_code\": {\n        \"ticker\": \"BIT/USD\",\n        \"exchange_code\": \"CXKRKN\"\n      }\n    },\n    {\n      \"guid\": \"ca820109-b49a-4835-8422-96698eb65b53\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.dev.tpinf.in/takeprofit.reference.external.security.v1.SecurityInfoApi.ListSecurities")
  .header("Content-Type", "application/json")
  .body("{\n  \"security_ids\": [\n    {\n      \"ticker_code\": {\n        \"ticker\": \"TSLA\",\n        \"exchange_code\": \"BATS\"\n      }\n    },\n    {\n      \"ticker_code\": {\n        \"ticker\": \"AAPL\",\n        \"exchange_code\": \"BATS\"\n      }\n    },\n    {\n      \"ticker_code\": {\n        \"ticker\": \"ETH/USDT\",\n        \"exchange_code\": \"CXBNCE\"\n      }\n    },\n    {\n      \"ticker_code\": {\n        \"ticker\": \"BIT/USD\",\n        \"exchange_code\": \"CXKRKN\"\n      }\n    },\n    {\n      \"guid\": \"ca820109-b49a-4835-8422-96698eb65b53\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.dev.tpinf.in/takeprofit.reference.external.security.v1.SecurityInfoApi.ListSecurities")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"security_ids\": [\n    {\n      \"ticker_code\": {\n        \"ticker\": \"TSLA\",\n        \"exchange_code\": \"BATS\"\n      }\n    },\n    {\n      \"ticker_code\": {\n        \"ticker\": \"AAPL\",\n        \"exchange_code\": \"BATS\"\n      }\n    },\n    {\n      \"ticker_code\": {\n        \"ticker\": \"ETH/USDT\",\n        \"exchange_code\": \"CXBNCE\"\n      }\n    },\n    {\n      \"ticker_code\": {\n        \"ticker\": \"BIT/USD\",\n        \"exchange_code\": \"CXKRKN\"\n      }\n    },\n    {\n      \"guid\": \"ca820109-b49a-4835-8422-96698eb65b53\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "securities": [
    {
      "status": {
        "code": 0,
        "message": "",
        "details": []
      },
      "security_id": {
        "ticker_code": {
          "ticker": "TSLA",
          "exchange_code": "BATS"
        }
      },
      "security_info": {
        "ticker": "TSLA",
        "names": {
          "en": "Tesla, Inc."
        },
        "exchange_code": "BATS",
        "cfi": "MMMXXX",
        "isin": "US88160R1014",
        "status": 1,
        "price_precision": 2,
        "tick_size": {
          "value": "1",
          "scale": "10000"
        },
        "asset_base": {
          "id": {
            "code": "TSLA",
            "asset_class_code": "EQUITY"
          },
          "icon_url": "https://cdn.takeprofit.team/reference/stage/icons/cl_tsla_15835_dark.svg",
          "background_color": "#ffffff",
          "company": {
            "name": "Tesla, Inc.",
            "industries": [
              {
                "name": "Motor Vehicles",
                "industries": []
              }
            ]
          }
        },
        "asset_quote": {
          "id": {
            "code": "USD",
            "asset_class_code": "CURRENCY"
          }
        },
        "classes": [
          {
            "name": "Common stocks",
            "parent_class": {
              "name": "Equity"
            },
            "top_level_class": {
              "name": "Equity"
            }
          }
        ],
        "guid": "0e999ee4-f44f-4cb7-a769-6ac37e72f6db",
        "exchange_alias": "NASDAQ",
        "price_precisions": [
          {
            "price_from": {
              "value": "0",
              "scale": "0"
            },
            "price_to": {
              "value": "1",
              "scale": "0"
            },
            "precision": 4
          },
          {
            "price_from": {
              "value": "1",
              "scale": "0"
            },
            "precision": 2
          }
        ]
      }
    },
    {
      "status": {
        "code": 0,
        "message": "",
        "details": []
      },
      "security_id": {
        "ticker_code": {
          "ticker": "AAPL",
          "exchange_code": "BATS"
        }
      },
      "security_info": {
        "ticker": "AAPL",
        "names": {
          "en": "Apple Inc."
        },
        "exchange_code": "BATS",
        "cfi": "MMMXXX",
        "isin": "US0378331005",
        "status": 1,
        "price_precision": 2,
        "tick_size": {
          "value": "1",
          "scale": "10000"
        },
        "asset_base": {
          "id": {
            "code": "AAPL",
            "asset_class_code": "EQUITY"
          },
          "icon_url": "https://cdn.takeprofit.team/reference/stage/icons/cl_aapl_27246_bright.svg",
          "background_color": "#1D1D1F",
          "company": {
            "name": "Apple, Inc.",
            "industries": [
              {
                "name": "Telecommunications Equipment",
                "industries": []
              }
            ]
          }
        },
        "asset_quote": {
          "id": {
            "code": "USD",
            "asset_class_code": "CURRENCY"
          }
        },
        "classes": [
          {
            "name": "Common stocks",
            "parent_class": {
              "name": "Equity"
            },
            "top_level_class": {
              "name": "Equity"
            }
          }
        ],
        "guid": "6ef11658-5a1c-4baf-9387-d977dcca6129",
        "exchange_alias": "NASDAQ",
        "price_precisions": [
          {
            "price_from": {
              "value": "0",
              "scale": "0"
            },
            "price_to": {
              "value": "1",
              "scale": "0"
            },
            "precision": 4
          },
          {
            "price_from": {
              "value": "1",
              "scale": "0"
            },
            "precision": 2
          }
        ]
      }
    },
    {
      "status": {
        "code": 5,
        "message": "NOT_FOUND",
        "details": []
      },
      "security_id": {
        "ticker_code": {
          "ticker": "XXXDF",
          "exchange_code": "BATS"
        }
      }
    }
  ]
}

Reference API

Security Info

The Security Info method allows you to retrieve detailed information about multiple securities identified by ticker and exchange code or by GUID.

Request Body

security_ids (required): An array of security identifiers.

Each element can contain one of the following options:
- ticker_code:
  - ticker (string): The security’s ticker symbol.
  - exchange_code (string): The exchange code.
- guid (string): The security’s Global Unique Identifier.

Response

securities: An array of objects containing information about each requested security.
- status:
  - code (integer): Operation status code (0 - success).
  - message (string): Status message.
  - details (array): Additional details.
- security_id: The security identifier corresponding to the request.
- security_info: Detailed information about the security.
  - ticker (string): The security’s ticker symbol.
  - names (map): Names in different languages.
  - exchange_code (string): The exchange code.
  - cfi (string): ISO 10962 (CFI) code.
  - isin (string): International Securities Identification Number (ISIN).
  - status (integer): Security status (1 - active).
  - price_precision (integer): Price precision (number of decimal places).
  - tick_size: Price tick size.
    - value (string): The value.
    - scale (string): The scale (divisor).
  - asset_base: Base asset.
    - id:
      - code (string): Asset code.
      - asset_class_code (string): Asset class code.
    - icon_url (string): URL of the asset’s icon.
    - background_color (string): Background color.
    - company: Company information.
      - name (string): Company name.
      - industries (array): Industries.
  - asset_quote: Quote asset.
    - id:
      - code (string): Asset code.
      - asset_class_code (string): Asset class code.
  - classes: Security classes.
  - guid (string): Global Unique Identifier.
  - exchange_alias (string): Exchange alias.
  - price_precisions: Array of price precision settings for different ranges.

JSON Schemas

Request Schema

{
  "type": "object",
  "properties": {
    "security_ids": {
      "type": "array",
      "items": {
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "ticker_code": {
                "type": "object",
                "properties": {
                  "ticker": { "type": "string" },
                  "exchange_code": { "type": "string" }
                },
                "required": ["ticker", "exchange_code"]
              }
            },
            "required": ["ticker_code"]
          },
          {
            "type": "object",
            "properties": {
              "guid": { "type": "string" }
            },
            "required": ["guid"]
          }
        ]
      }
    }
  },
  "required": ["security_ids"]
}

Response Schema

{
  "type": "object",
  "properties": {
    "securities": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "status": {
            "$ref": "#/definitions/Status"
          },
          "security_id": {
            "$ref": "#/definitions/SecurityId"
          },
          "security_info": {
            "$ref": "#/definitions/SecurityInfo"
          }
        }
      }
    }
  },
  "definitions": {
    "Status": {
      "type": "object",
      "properties": {
        "code": { "type": "integer" },
        "message": { "type": "string" },
        "details": { "type": "array", "items": {} }
      }
    },
    "SecurityId": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "ticker_code": {
              "type": "object",
              "properties": {
                "ticker": { "type": "string" },
                "exchange_code": { "type": "string" }
              },
              "required": ["ticker", "exchange_code"]
            }
          }
        },
        {
          "type": "object",
          "properties": {
            "guid": { "type": "string" }
          }
        }
      ]
    },
    "SecurityInfo": {
      "type": "object",
      "properties": {
        "ticker": { "type": "string" },
        "names": {
          "type": "object",
          "additionalProperties": { "type": "string" }
        },
        "exchange_code": { "type": "string" },
        "cfi": { "type": "string" },
        "isin": { "type": "string" },
        "status": { "type": "integer" },
        "price_precision": { "type": "integer" },
        "tick_size": { "$ref": "#/definitions/Decimal" },
        "asset_base": { "$ref": "#/definitions/Asset" },
        "asset_quote": { "$ref": "#/definitions/Asset" },
        "classes": {
          "type": "array",
          "items": { "$ref": "#/definitions/SecurityClass" }
        },
        "guid": { "type": "string" },
        "exchange_alias": { "type": "string" },
        "price_precisions": {
          "type": "array",
          "items": { "$ref": "#/definitions/PricePrecision" }
        }
      }
    },
    "Decimal": {
      "type": "object",
      "properties": {
        "value": { "type": "string" },
        "scale": { "type": "string" }
      }
    },
    "Asset": {
      "type": "object",
      "properties": {
        "id": { "$ref": "#/definitions/AssetId" },
        "icon_url": { "type": "string" },
        "background_color": { "type": "string" },
        "company": { "$ref": "#/definitions/Company" }
      }
    },
    "AssetId": {
      "type": "object",
      "properties": {
        "code": { "type": "string" },
        "asset_class_code": { "type": "string" }
      }
    },
    "Company": {
      "type": "object",
      "properties": {
        "name": { "type": "string" },
        "industries": {
          "type": "array",
          "items": { "$ref": "#/definitions/Industry" }
        }
      }
    },
    "Industry": {
      "type": "object",
      "properties": {
        "name": { "type": "string" },
        "industries": {
          "type": "array",
          "items": {}
        }
      }
    },
    "SecurityClass": {
      "type": "object",
      "properties": {
        "name": { "type": "string" },
        "parent_class": { "$ref": "#/definitions/SecurityClass" },
        "top_level_class": { "$ref": "#/definitions/SecurityClass" }
      }
    },
    "PricePrecision": {
      "type": "object",
      "properties": {
        "price_from": { "$ref": "#/definitions/Decimal" },
        "price_to": { "$ref": "#/definitions/Decimal" },
        "precision": { "type": "integer" }
      }
    }
  }
}

Usage Recommendations

Authorization: Always use a valid access_token in the accesstoken header.
Error Handling: Check the status field in the response to determine the success of the operation.
Identifiers: Use guid for unique identification of securities when possible.

Frequently Asked Questions

What should I do if I receive an “Invalid access token” error?

Ensure you are using a valid access_token obtained through the Auth API. Tokens may expire, in which case you need to obtain a new one using the refresh_token.

Can I request information about a single security?

Yes, you can specify a single identifier in the security_ids array.

How can I get a list of available exchanges and their codes?

Refer to the relevant documentation or API that provides information about exchanges.

Additional Resources

POST

takeprofit.reference.external.security.v1.SecurityInfoApi.ListSecurities

Security Info

curl --request POST \
  --url https://api.dev.tpinf.in/takeprofit.reference.external.security.v1.SecurityInfoApi.ListSecurities \
  --header 'Content-Type: application/json' \
  --data '
{
  "security_ids": [
    {
      "ticker_code": {
        "ticker": "TSLA",
        "exchange_code": "BATS"
      }
    },
    {
      "ticker_code": {
        "ticker": "AAPL",
        "exchange_code": "BATS"
      }
    },
    {
      "ticker_code": {
        "ticker": "ETH/USDT",
        "exchange_code": "CXBNCE"
      }
    },
    {
      "ticker_code": {
        "ticker": "BIT/USD",
        "exchange_code": "CXKRKN"
      }
    },
    {
      "guid": "ca820109-b49a-4835-8422-96698eb65b53"
    }
  ]
}
'

import requests

url = "https://api.dev.tpinf.in/takeprofit.reference.external.security.v1.SecurityInfoApi.ListSecurities"

payload = { "security_ids": [{ "ticker_code": {
                "ticker": "TSLA",
                "exchange_code": "BATS"
            } }, { "ticker_code": {
                "ticker": "AAPL",
                "exchange_code": "BATS"
            } }, { "ticker_code": {
                "ticker": "ETH/USDT",
                "exchange_code": "CXBNCE"
            } }, { "ticker_code": {
                "ticker": "BIT/USD",
                "exchange_code": "CXKRKN"
            } }, { "guid": "ca820109-b49a-4835-8422-96698eb65b53" }] }
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    security_ids: [
      {ticker_code: {ticker: 'TSLA', exchange_code: 'BATS'}},
      {ticker_code: {ticker: 'AAPL', exchange_code: 'BATS'}},
      {ticker_code: {ticker: 'ETH/USDT', exchange_code: 'CXBNCE'}},
      {ticker_code: {ticker: 'BIT/USD', exchange_code: 'CXKRKN'}},
      {guid: 'ca820109-b49a-4835-8422-96698eb65b53'}
    ]
  })
};

fetch('https://api.dev.tpinf.in/takeprofit.reference.external.security.v1.SecurityInfoApi.ListSecurities', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dev.tpinf.in/takeprofit.reference.external.security.v1.SecurityInfoApi.ListSecurities",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'security_ids' => [
        [
                'ticker_code' => [
                                'ticker' => 'TSLA',
                                'exchange_code' => 'BATS'
                ]
        ],
        [
                'ticker_code' => [
                                'ticker' => 'AAPL',
                                'exchange_code' => 'BATS'
                ]
        ],
        [
                'ticker_code' => [
                                'ticker' => 'ETH/USDT',
                                'exchange_code' => 'CXBNCE'
                ]
        ],
        [
                'ticker_code' => [
                                'ticker' => 'BIT/USD',
                                'exchange_code' => 'CXKRKN'
                ]
        ],
        [
                'guid' => 'ca820109-b49a-4835-8422-96698eb65b53'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dev.tpinf.in/takeprofit.reference.external.security.v1.SecurityInfoApi.ListSecurities"

	payload := strings.NewReader("{\n  \"security_ids\": [\n    {\n      \"ticker_code\": {\n        \"ticker\": \"TSLA\",\n        \"exchange_code\": \"BATS\"\n      }\n    },\n    {\n      \"ticker_code\": {\n        \"ticker\": \"AAPL\",\n        \"exchange_code\": \"BATS\"\n      }\n    },\n    {\n      \"ticker_code\": {\n        \"ticker\": \"ETH/USDT\",\n        \"exchange_code\": \"CXBNCE\"\n      }\n    },\n    {\n      \"ticker_code\": {\n        \"ticker\": \"BIT/USD\",\n        \"exchange_code\": \"CXKRKN\"\n      }\n    },\n    {\n      \"guid\": \"ca820109-b49a-4835-8422-96698eb65b53\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.dev.tpinf.in/takeprofit.reference.external.security.v1.SecurityInfoApi.ListSecurities")
  .header("Content-Type", "application/json")
  .body("{\n  \"security_ids\": [\n    {\n      \"ticker_code\": {\n        \"ticker\": \"TSLA\",\n        \"exchange_code\": \"BATS\"\n      }\n    },\n    {\n      \"ticker_code\": {\n        \"ticker\": \"AAPL\",\n        \"exchange_code\": \"BATS\"\n      }\n    },\n    {\n      \"ticker_code\": {\n        \"ticker\": \"ETH/USDT\",\n        \"exchange_code\": \"CXBNCE\"\n      }\n    },\n    {\n      \"ticker_code\": {\n        \"ticker\": \"BIT/USD\",\n        \"exchange_code\": \"CXKRKN\"\n      }\n    },\n    {\n      \"guid\": \"ca820109-b49a-4835-8422-96698eb65b53\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.dev.tpinf.in/takeprofit.reference.external.security.v1.SecurityInfoApi.ListSecurities")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"security_ids\": [\n    {\n      \"ticker_code\": {\n        \"ticker\": \"TSLA\",\n        \"exchange_code\": \"BATS\"\n      }\n    },\n    {\n      \"ticker_code\": {\n        \"ticker\": \"AAPL\",\n        \"exchange_code\": \"BATS\"\n      }\n    },\n    {\n      \"ticker_code\": {\n        \"ticker\": \"ETH/USDT\",\n        \"exchange_code\": \"CXBNCE\"\n      }\n    },\n    {\n      \"ticker_code\": {\n        \"ticker\": \"BIT/USD\",\n        \"exchange_code\": \"CXKRKN\"\n      }\n    },\n    {\n      \"guid\": \"ca820109-b49a-4835-8422-96698eb65b53\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "securities": [
    {
      "status": {
        "code": 0,
        "message": "",
        "details": []
      },
      "security_id": {
        "ticker_code": {
          "ticker": "TSLA",
          "exchange_code": "BATS"
        }
      },
      "security_info": {
        "ticker": "TSLA",
        "names": {
          "en": "Tesla, Inc."
        },
        "exchange_code": "BATS",
        "cfi": "MMMXXX",
        "isin": "US88160R1014",
        "status": 1,
        "price_precision": 2,
        "tick_size": {
          "value": "1",
          "scale": "10000"
        },
        "asset_base": {
          "id": {
            "code": "TSLA",
            "asset_class_code": "EQUITY"
          },
          "icon_url": "https://cdn.takeprofit.team/reference/stage/icons/cl_tsla_15835_dark.svg",
          "background_color": "#ffffff",
          "company": {
            "name": "Tesla, Inc.",
            "industries": [
              {
                "name": "Motor Vehicles",
                "industries": []
              }
            ]
          }
        },
        "asset_quote": {
          "id": {
            "code": "USD",
            "asset_class_code": "CURRENCY"
          }
        },
        "classes": [
          {
            "name": "Common stocks",
            "parent_class": {
              "name": "Equity"
            },
            "top_level_class": {
              "name": "Equity"
            }
          }
        ],
        "guid": "0e999ee4-f44f-4cb7-a769-6ac37e72f6db",
        "exchange_alias": "NASDAQ",
        "price_precisions": [
          {
            "price_from": {
              "value": "0",
              "scale": "0"
            },
            "price_to": {
              "value": "1",
              "scale": "0"
            },
            "precision": 4
          },
          {
            "price_from": {
              "value": "1",
              "scale": "0"
            },
            "precision": 2
          }
        ]
      }
    },
    {
      "status": {
        "code": 0,
        "message": "",
        "details": []
      },
      "security_id": {
        "ticker_code": {
          "ticker": "AAPL",
          "exchange_code": "BATS"
        }
      },
      "security_info": {
        "ticker": "AAPL",
        "names": {
          "en": "Apple Inc."
        },
        "exchange_code": "BATS",
        "cfi": "MMMXXX",
        "isin": "US0378331005",
        "status": 1,
        "price_precision": 2,
        "tick_size": {
          "value": "1",
          "scale": "10000"
        },
        "asset_base": {
          "id": {
            "code": "AAPL",
            "asset_class_code": "EQUITY"
          },
          "icon_url": "https://cdn.takeprofit.team/reference/stage/icons/cl_aapl_27246_bright.svg",
          "background_color": "#1D1D1F",
          "company": {
            "name": "Apple, Inc.",
            "industries": [
              {
                "name": "Telecommunications Equipment",
                "industries": []
              }
            ]
          }
        },
        "asset_quote": {
          "id": {
            "code": "USD",
            "asset_class_code": "CURRENCY"
          }
        },
        "classes": [
          {
            "name": "Common stocks",
            "parent_class": {
              "name": "Equity"
            },
            "top_level_class": {
              "name": "Equity"
            }
          }
        ],
        "guid": "6ef11658-5a1c-4baf-9387-d977dcca6129",
        "exchange_alias": "NASDAQ",
        "price_precisions": [
          {
            "price_from": {
              "value": "0",
              "scale": "0"
            },
            "price_to": {
              "value": "1",
              "scale": "0"
            },
            "precision": 4
          },
          {
            "price_from": {
              "value": "1",
              "scale": "0"
            },
            "precision": 2
          }
        ]
      }
    },
    {
      "status": {
        "code": 5,
        "message": "NOT_FOUND",
        "details": []
      },
      "security_id": {
        "ticker_code": {
          "ticker": "XXXDF",
          "exchange_code": "BATS"
        }
      }
    }
  ]
}

Headers

accesstoken

string

JWT access token

Body

application/json

The body is of type object.

Response

200 - application/json

The response is of type object.

Getting Started

Credentials

Link

Reference API

Marketdata API

Security Info

Request Body

Response

JSON Schemas

Request Schema

Response Schema

Usage Recommendations

Frequently Asked Questions

What should I do if I receive an “Invalid access token” error?

Can I request information about a single security?

How can I get a list of available exchanges and their codes?

Additional Resources

Headers

Body

Response