Documentation

Lookup a symbol

Lookup a symbol or partial symbol. Results are ordered by average volume of the symbol.

Endpoint

Method
GET
URL
/v1/markets/lookup

Headers

Accept
application/xml, application/json, application/javascript
Default: application/xml
Required: false
Authorization
Bearer {access token}
Required: true

Query Parameters

q
A symbol or partial symbol to look up
Optional: true
exchanges
A comma-delimited list of exchange codes to query
Example: exchanges=Q,N
Optional: true
types
A comma-delimited list of security types to query
Valid types are stock, etf, index
Example: types=stock,etf
Optional: true

Note: At least one of the following parameters is required: q, exchanges, types

Response

Field Description
symbol Symbol of the company
exchange Exchange where the company is listed
type Type of the security (stock, etf, index)
description Company description

Example

Command

$ curl -H "Authorization: Bearer {access token}" https://api.tradier.com/v1/markets/lookup?q=goo

Request

GET /v1/markets/search?q=goo HTTP/1.1
Host: api.tradier.com
Accept: application/xml
Authorization: Bearer 098f6bcd4621d373cade4e832627b4f6

Response

HTTP/1.1 200 OK
Content-Type: application/xml;charset=utf-8
X-Ratelimit-Allowed: 60
X-Ratelimit-Used: 1
X-Ratelimit-Available: 59
X-Ratelimit-Expiry: 1369164360001

<?xml version="1.0" encoding="UTF-8"?>
<securities>
  <security>
    <symbol>GOOGL</symbol>
    <exchange>XNAS</exchange>
    <type>stock</type>
    <description>Google Inc</description>
  </security>
  <security>
    <symbol>GOOD</symbol>
    <exchange>XNAS</exchange>
    <type>stock</type>
    <description>Gladstone Commercial Corp</description>
  </security>
  <security>
    <symbol>GOODN</symbol>
    <exchange>XNAS</exchange>
    <type>stock</type>
    <description>Gladstone Commercial Corporation - 7.125% Series C Cumulative Term Preferred Stock</description>
  </security>
  <security>
    <symbol>GOODO</symbol>
    <exchange>XNAS</exchange>
    <type>stock</type>
    <description>Gladstone Commercial Corporation - 7.50% Series B Cumulative Redeemable Preferred Stock</description>
  </security>
  <security>
    <symbol>GOODP</symbol>
    <exchange>XNAS</exchange>
    <type>stock</type>
    <description>Gladstone Commercial Corporation - 7.75% Series A Cumulative Redeemable Preferred Stock</description>
  </security>
  <security>
    <symbol>GOOG</symbol>
    <exchange>XNAS</exchange>
    <type>stock</type>
    <description>Google Inc. - Class C Capital Stock</description>
  </security>
</securities>

Tradier Inc. and its corresponding technology services (including API services) are distinct and separate from the services provided by Tradier Brokerage Inc. For more information regarding the services of Tradier, Inc., please contact techsupport@tradier.com. For more information regarding the services of Tradier Brokerage, Inc. please contact service@tradierbrokerage.com. Tradier Brokerage Inc. Member FINRA/SIPC

© 2017 Tradier Inc.
  • 11016 Rushmore Drive, Suite 350
  • Charlotte, NC 28277

All materials contained on this site and specifically the API documentation pages are protected by United States copyright law and may not be copied, reproduced, distributed, transmitted, displayed, published or broadcast without the prior written permission of Tradier Inc. The Structure, Format, Layout, Examples and Design of the pages are owned by Tradier Inc, and any efforts to willfully or accidently duplicate a whole or part of the pages on this site is a violation of United States copyright law.