StockTwits API

The StockTwits API enables developers to access many StockTwits features including ticker and user streams, message and chart sharing, and the StockTwits social graph from within their applications. Use our API to build a social layer into any financial application or web site. Drive more engagement for your audience and reach for your content through the StockTwits community and the connections your users already have created through our network. You can also increase engagement with our unique, curated conversation streams focused on securities and dedicated financial topics. The API presently support JSON format. Dive into the API methods

Authentication

When a StockTwits user authorizes your application, your application gets access to the user's StockTwits account. By default, your application can only access the user's public data. If your application needs to read private data or change user's associated data, your application can request a larger permission scope. StockTwits uses the open authentication OAuth 2.0 for authentication. Learn more about authentication and how to sign in users with StockTwits to your website.

Rate Limits

The StockTwits API only allows clients to make a limited number of calls in a given hour. The default rate limit for calls to the REST API varies depending on the authorization method being used and whether the method itself requires authentication. Learn about the limits

Error and Response Codes

All API responses return a JSON object with the appropriate HTTP status codes and additional data, like error messages. Error messages contain machine-parseable codes as well as additional descriptive error text. View all the codes and responses

Display Guidelines

It is important that when you integrate StockTwits functionality into your site or application you do so in a consistent manner. We have put together some guidelines on how to display StockTwits content on your site. We have also provided the appropriate logos and graphics to help you develop your applications. Learn more about display guidlines

Cashtag Linking and Character Counting

Messages on StockTwits are organized around financial securities using a $ before the ticker symbol, also known as a cashtag. Linking to cashtags within a message can be a challenge. We have created a library which provides autolinking and extraction for cashtags. We are always keeping this up to date with the newest symbols in our symbology. Learn more and get the library

The StockTwits messages have character limits and this can be a challenge to work with as you publish messages. There are a few rules when on how characters are counted. We have put together information on the hard rules and how all these characters get counted. Learn more about character counting

StockTwits Symbology

At StockTwits we use our $TICKER Cashtags to support discussions for almost 10,000 symbols representing supported publicly traded equities as well as Futures and Forex instruments. To enable developers to keep up we have created a symbology file which includes all supported Cashtags (including NYSE, NASDAQ, NYSE Mkt, NYSEL Arca and TSX listed equities as well as Futures and Forex instruments). This file is updated daily and includes the StockTwits ID, Symbol, Exchange and Equity Name. These are all symbols that are currently being talked about by the StockTwits community. Note that we don't currently support Bulletin Board stocks. Download the StockTwits symbology

API Support

We have tried our best to provide documentation and tools to work with the StockTwits API, but sometimes you have a questions or issue. Feel free to post on our discussion forum and search for past issues to find answers. We will be in there answering as much as we can. You can also email us at api@stocktwits.com and we will try and get back to you as soon as possible.

Last Updated on January 30, 2013

This Application Programming Interface License Agreement (the “Agreement”) dated as of the date of acceptance by means of a click-through, is made by and among Stocktwits, Inc, a Delaware Corporation (“Stocktwits”) and the user designated by the registration data provided herewith (“Licensee”).

THIS LICENSE AGREEMENT GOVERNS YOUR USE OF THE STOCKTWITS APPLICATION PROGRAMMING INTERFACE (API) PROTOCOLS AND ACCESS KEY PROVIDED TO YOU BY STOCKTWITS (REFERRED AS THE “STOCKTWITS API”) IN ORDER TO ACCESS FUNCTIONALITY OF THE STOCKTWITS WEBSITE OR RECEIVE OR TRANSMIT DATA TO OR FROM THE STOCKTWITS WEBSITE (REFERRED TO AS THE “STOCKTWITS DATA”) .

READ THIS LICENSE CAREFULLY BEFORE CLICKING ON “I ACCEPT”. IF YOU DO NOT AGREE WITH THESE TERMS, THEN CLICK “CANCEL”. YOUR CONTINUED USE OF THE STOCKTWITS API TO OPERATE ANY FUNCTIONALITY OF THE STOCKTWITS WEBSITE OR ACCESS ANY STOCKTWITS DATA SHALL CONSTITUTE YOUR ACCEPTANCE OF THE TERMS AND CONDITIONS OF THIS AGREEMENT INCLUDING ANY CHANGES THAT STOCKTWITS MAKES TO SUCH TERMS AND CONDITIONS PRIOR TO SUCH CONTINUED USE.

YOU REPRESENT AND WARRANT THAT YOU ARE AT LEAST 18 YEARS OLD.

THE STOCKTWITS API, STOCKTWITS DATA AND STOCKTWITS WEBSITE ARE PROVIDED AS IS. YOU AGREE THAT ANY USE OF THE STOCKTWITS API, STOCKTWITS DATA AND STOCKTWITS WEBSITE IS AT LICENSEE’S (YOUR) SOLE AND ABSOLUTE RISK. IN NO EVENT, WILL STOCKTWITS, INC BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OF OR INABILITY TO USE THE STOCKTWITS API, STOCKTWITS DATA OR STOCKTWITS WEBSITE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SPECIFICALLY, LICENSEE (YOU) AGREE THAT STOCKTWITS, INC IS NOT RESPONSIBLE FOR ANY DAMAGES INCURRED BY LICENSEE (YOU) INCLUDING, BUT NOT LIMITED TO, THOSE INCURRED AS A RESULT OF LOST PROFITS OR REVENUE, LOSS OF REPUTATION, DEFAMATION, COPYRIGHT OR PATENT INFRINGEMENT, LOSS OF DATA, DISCLOSURE OF DATA, OR CLAIMS BY THIRD PARTIES, OR FOR OTHER COSTS OR CLAIMS.

LICENSE: Subject to compliance with all of the terms of this license, Stocktwits hereby grants Licensee a non-exclusive, paid-up, royalty-free, non-transferrable right and license, throughout the world, without the right to sublicense to operate the Stocktwits API and to integrate one or more parts of the Stocktwits API into Licensee’s website, mobile or desktop application (the “Application”) solely for use by Licensee’s end users, and to display the Stocktwits Data on such Application, but not for any kind of re-distribution of the Stocktwits Data, whether instantaneous or as copies of archived data, whether whole or in part.

Subject to compliance with all of the terms of this license, Stocktwits, Inc., hereby grants Licensee a limited, at-will, non-exclusive, non-transferrable license without the right to sublicense to (i) display on Licensee’s Application the Stoctwits trademark and logo and (ii) use, copy, transmit and operate the components of the stocktwits-text-js code library solely in order that the Application display messages in accordance with the Content Display Requirements. Use of the Stocktwits trademark and logo as well as all or part of the stocktwits-text-js code library is at your sole and absolute risk. Any goodwill arising from use of the Stocktwits trademark or logo shall inure to the sole benefit of Stocktwits.

Any rights not expressly granted hereunder are reserved by Stocktwits. You agree that there are no implied rights granted by this Agreement.

YOU AGREE THAT YOU SHALL NOT ATTEMPT TO ENTER PARTS OF THE STOCKTWITS WEBSITE THAT YOU ARE NOT AUTHORIZED TO ENTER, TAMPER WITH THE STOCKTWITS WEBSITE, ATTEMPT TO ACCESS ANY DATA YOU ARE NOT AUTHORIZED TO ACCESS, ATTEMPT TO EXERCISE ANY API OTHER THAN THAT LICENSED HEREUNDER, ATTEMPT TO DISABLE OR IMPAIR THE STOCKTWITS WEBSITE, OR USE THE STOCKTWITS WEBSITE TO COMMIT ANY CRIMINAL ACT OR INTENTIONAL INJURY OF ANY THIRD PARTY.

LICENSEE APPLICATION REQUIREMENTS: The rights granted in the Stocktwits API and Stocktwits Data are subject to the Licensee’s Application meeting the following requirements:

Licensee’s Application shall display all messages returned by the Stocktwits API in their entirety, in the order they are received and not selectively display or delete messages from the data stream; Licensee’s Application shall not block, re-order or otherwise alter any messages that may be promotional or paid placements within the streams; Licensee’s Application shall display all messages in compliance with Stocktwits’ Content Display Requirements, available here: http://stocktwits.com/developers/docs/display_requirement Licensee’s Application shall clearly identify each Stocktwits message or message stream as sourced from StockTwits by using the Stocktwits trademark in accordance with the Content Display Requirements; Licensee’s Application may cache or store Stocktwits Data for the operation of its service, however any messages contained within the Stocktwits Data cannot be stored for more than 30 days for any purpose; If Licensee’s Application displays Stocktwits Data as a message stream, then the Licensee Application shall not co-mingle any similar native or third-party messages with the Stocktwits Data stream; If Licensee Application displays Stocktwits Data as individual messages and also shows similar native or third-party messages, Stocktwits Data must be clearly identified as coming from Stocktwits, by using the Stocktwits trademark in accordance with the Content Display Requirements; If Licensee’s Application presents its end-users an option for the end-user to sign in with Stocktwits’ credentials and/or send content to that end-user’s Stocktwits account, and Licensee’s Application also provides those same capabilities for additional third party platforms, the display of the option to use Stocktwits must be presented with at least the same prominence as any other platform; Licensee must have adopted and promulgated a privacy policy that it abides by and it must meet the privacy laws of the U.S., Canada and the European Union; RESTRICTIONS ON THE LICENSEE: The rights granted hereunder are conditioned on the Licensee, Licensee’s Application and Licensee’s end-users abiding by the following restrictions:

Licensee shall not redistribute, resell, export, transmit or sublicense any of the Stocktwits Data or otherwise provide access to the Stocktwits Website to any third party, except for transmission to the end-users of Licensee’s Application that are in compliance with the Stocktwits Terms of Use for display to such end-user. Licensee shall not create, disclose, sell, or display any information derived by analysis of the Stocktwits Data or the Stocktwits API, including, without limitation, any message trend information, sentiment information, Stocktwits messaging performance or any summaries of the foregoing or any other kind of algorithmic products using the Stocktwits Data or Stocktwits Website ; Licensee shall not use the Stocktwits Data or Stocktwits API to compete with StockTwits including, without limitation using the Stocktwits API and Stocktwits Data to offer a product or service consisting primarily of Stocktwits Website functionality, as determined by Stocktwits in its sole and absolute discretion; Licensee shall and the users of Licensee’s Application shall enter into and comply with both the House Rules and Stocktwits Terms of Use, available here: http://stocktwits.com/rules and http://stocktwits.com/terms. . Licensee shall not use the Stocktwits API to transmit any messages that are primarily commercial solicitations into the Stocktwits message stream; Licensee shall not violate any Federal rule or guideline or any other applicable law regarding the transmission of messages that are commercial advertising, offers or solicitations of any kind. Licensee shall not and shall not permit Licensee’s users to use the Stocktwits API or Stocktwits Data to violate any Federal, State security law or the law of any other jurisdiction that governs trading in securities; Licensee shall not alter, modify or adapt the Stocktwits Website, including but not limited to, translating, decompiling, disassembling, reverse engineering, or creating derivative works of the Stocktwits Website; Licensee and Licensee’s end-users shall not transmit into the Stocktwits message stream any (i) defamatory message; (ii) harassing or pornographic message; (iii) computer virus, keylogger, bot or other malicious code or link to such code, (iv) any data or content that infringes the copyright of any third party or (v) message containing misleading or incorrect information about a security that Licensee knows or has a reasonable suspicion is designed to induce one or more third parties to make a security trade in such security. TERMINATION: Stocktwits and Licensee may terminate this Agreement at any time, for any reason or no reason. This license and Licensee’s right to use the Stocktwits API, Stocktwits Website and Stocktwits Data shall automatically terminate and revert in the event Licensee, Licensee’s Application or any of Licensee’s end-users fail to comply with any provision of this Agreement. Upon termination, Stocktwits shall have the right to terminate the Licensee’s Stocktwits account and delete any data contained in the account.

ACKNOWLEDGMENT: Licensee acknowledges that: (i) Stocktwits is under no obligation to repair, operate, maintain or continue to operate the Stocktwits API or provide the Stocktwits Data and that these functions may fail from time to time, (ii) Stocktwits may alter the Stocktwits API from time to time, which may cause malfunction of Licensee’s Application and (iii) that Licensee is solely responsible to revise or maintain their Application in order that it is compatible with any revisions of the Stocktwits API or Stocktwits Website.

REPRESENTATION: The person assenting to this Application Programming Interface License Agreement represents and warrants that it has the right and power to enter into this Agreement and that all of the registration information provided to Stocktwits is accurate.

MISCELLANEOUS: The following provisions shall apply to this Agreement and survive termination of this Agreement:

This Agreement shall be construed under the laws of the State of California, without the application of its conflict of law rules or principles. Licensee agrees that the exclusive venue for any dispute arising hereunder is the state and federal courts located in San Diego County, California, USA. Licensee waives any claim that such a venue is an inconvenient forum.

Licensee agrees to indemnify and hold Stocktwits, its subsidiaries and affiliates, and each of their members, shareholders, managers, directors, officers, agents, contractors, partners and employees, harmless from and against any loss, liability, claim, demand, damages, costs and expenses, including reasonable attorney's fees, arising out of or in connection with Licensee’s use of the Stocktwits API, any content Licensee or Licensee’s end-users post or share on or through Stocktwits, Licensee’s user’s conduct in connection with the use of the Stocktwits API or Stocktwits Website, or any breach of the terms of this Agreement. This indemnity shall survive any termination or cessation of use by Licensee or Licensee’s end-users of the Stocktwits API or Stocktwits Website.

Licensee shall neither assign nor delegate its rights or obligations hereunder in whole or in part to any person without the prior written approval of Stocktwits. Any purported assignment in breach of this agreement is and shall be null and void. This Agreement shall be binding upon and shall inure to the benefit of the parties and their respective successors and permitted assigns. This agreement contains the entire understanding of the parties hereto relating to the subject matter hereof and cannot be changed except by an instrument signed by an officer of Stocktwits and an officer of Licensee. A waiver by either party of any term or condition of this Agreement in any instance shall not be deemed or construed as a waiver of such term or condition for the future, or of any subsequent breach thereof. All remedies, rights, undertakings, obligations and agreements contained in this Agreement shall be cumulative and none of them shall be in limitation of any other remedy, right, undertaking, obligation or agreement of either party. If any term, provision, covenant or restriction of this Agreement is held by a court of competent jurisdiction to be invalid, void or unenforceable, the remainder of the terms, provisions, covenants and restriction of this Agreement shall remain in full force and effect and shall in no way be affected, impaired or invalidated. Licensee agrees that breach of this Agreement by Licensee will cause irreparable harm to Stocktwits, for which monetary damage would be difficult to ascertain or insufficient to remedy, thereby entitling Stocktwits to immediate, injunctive relief without the requirement of posting bond or paying costs.

Last 7 days, UTC

Average Latency
9ms

Average Uptime
100.0%

Current Status
Online

  • No information
  • Outage
  • Disruption
  • Normal
Average latency determined from Mashape to API Response time
OAuth 2.0 Authentication Show OAuth URLs - Show Curl Example
 

You will want to choose a response type. Please read authentication documentation here http://stocktwits.com/developers/docs/authentication


Authentication
Description
Parameter
String

The client identifier given to you by the API provider.

Client Id

Required

String

The consumer secret given to you by the API provider.

Client Secret

Required

String

A space-delimited string of access scopes.
Example: read watch_lists publish_watch_lists publish_messages direct_messages follow_users follow_stocks

Scope

Optional

Authenticate

Please set the callback URL to: http://guardian.mashape.com/callback

Endpoints

HTTP 200 : watchlist GET/watchlists.json
						{
  "response": {
    "status": 200
  },
  "watchlists": [
    {
      "id": 36477,
      "name": "Mobile Watchlist",
      "updated_at": "2012-08-13T21:59:30Z",
      "created_at": "2012-06-26T02:03:39Z"
    },
    {
      "id": 38398,
      "name": "my picks",
      "updated_at": "2012-08-13T21:59:46Z",
      "created_at": "2012-08-10T22:03:24Z"
    }
  ]
}						
watchlists/index

Returns a list of private watch lists for the authenticating user.


Test console
Description
Parameter
string

Define your own callback function name, add this parameter as the value.

callback

Optional

HTTP 200 : watchlist/show GET/watchlists/show/{id}.json
						{
  "response": {"status":200},
  "watchlist": {
    "id": 38398,
    "name": "my picks",
    "updated_at": "2012-08-13T22:26:20Z",
    "created_at": "2012-08-10T22:03:24Z",
    "symbols": [
      {
        "id": 7871,
        "symbol": "FB",
        "title": "Facebook",
        
      },
      {
        "id": 2044,
        "symbol": "GOOG",
        "title": "Google Inc.",
        
      },
      {
        "id": 686,
        "symbol": "AAPL",
        "title": "Apple Inc.",
        
      }
    ]
  }
}						
watchlists/show

Returns the the list of ticker symbols in a specified watch list for the authenticating user. Required parameter is the ID of the watch list, not the name of the watch list.


Test console
Description
Parameter
string

The ID of the watch list to be shown

id

Required

string

Define your own callback function name, add this parameter as the value.

callback

Optional

Account

HTTP 200 : account/update GET/account/update.json
						{
  "response": {
    "status": 200
  },
  "user": {
    "id": 176388,
    "username": "stocktwits_dev",
    "name": "New Name",
    "avatar_url": "http://avatars.stocktwits.net/images/default_avatar_thumb.jpg",
    "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
    "identity": "User",
    "classification": [],
    "followers": 3,
    "following": 3,
    "ideas": 1,
    "following_stocks": 3,
    "bio": null,
    "website_url": null,
    "trading_strategy": {
      "assets_frequently_traded": [],
      "approach": null,
      "holding_period": null,
      "experience": null
    }
  }
}						
account/update

This updates the properties of the authenticating user's account.


Test console
Description
Parameter
string

The full name of the account holder

name

Optional

string

The email address for the account holder

email

Optional

string

The username for the account holder

username

Optional

HTTP 200 : account GET/account/verify.json
						{
  "response": {"status": 200},
  "user": {
    "id": 176389,
    "username": "jimmychanos",
    "name": "Jim Chanos",
    "avatar_url": "http://avatars.stocktwits.net/images/default_avatar_thumb.jpg",
    "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
    "identity": "User",
    "classification": [],
    
  }
}						
account/verify

This verifies the credentials of a user. Useful for checking if authentication method is correct.


Test console
Description
Parameter
string

Define your own callback function name, add this parameter as the value.

callback

Optional

Blocks

HTTP 200 : block POST/blocks/create/{id}.json
						{
  "response": {"status":200},
  "user": {
    "id": 176389,
    "username": "jimmychanos",
    "name": "Jim Chanos",
    "avatar_url": "http://avatars.stocktwits.net/images/default_avatar_thumb.jpg",
    "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
    "identity": "User",
    "classification": [],
    
  }
}						
blocks/create

This blocks a user so the authenticating user will not receive message from the specified user. Required parameter is the User ID of the user to block, not the username.


Test console
Description
Parameter
string

The ID of the user you want to block

id

Required

HTTP 200 : block POST/blocks/destroy/{id}.json
						{
  "response": {"status":200},
  "user": {
    "id": 176389,
    "username": "jimmychanos",
    "name": "Jim Chanos",
    "avatar_url": "http://avatars.stocktwits.net/images/default_avatar_thumb.jpg",
    "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
    "identity": "User",
    "classification": [],
    
  }
}						
blocks/destroy

This unblocks a user so the authenticating user can reveive messages from the specified user. required parameter is the User ID of the user to unblock, not the username.


Test console
Description
Parameter
string

The ID of the user you want to unblock

id

Required

Messages

HTTP 200 : message/create POST/messages/create.json
						{
  "response": {
    "status": 200
  },
  "message": {
    "id": 73,
    "body": "something about $NQ_F",
    "created_at": "2012-10-08 21:43:28 UTC",
    "user": {
      "id": 2,
      "username": "ppearlman",
      "name": "Phil Pearlman",
      "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
      "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
      "identity": "Official",
      "classification": [
        "ir",
        "suggested"
      ]
    },
    "source": {
      "id": 1,
      "title": "StockTwits",
      "url": "http://stocktwits.com"
    },
    "symbols": [
      {
        "id": 31,
        "symbol": "NQ_F",
        "title": "E-Mini NASDAQ 100 Futures",
      }
    ],
    "entities": {
      "chart": {
        "thumb": "/chart_images/small/missing.png",
        "original": "/chart_images/original/missing.png"
      }
    }
  }
}						
messages/create

Create a StockTwits message. To upload a chart to accompany the message, pass a file using the chart parameter. The API will check that the character count is under 140, will shorten all links, and prevent duplicate message postings. Learn more about parameters and character counting The reposonse returned on creating a message is a great way to use StockTwits context with content sent to another non-finacially focused social network such as Facebook, LinkedIn or Twitter. By using the body content that is returned you will receive the complete message compiled with any shortened links. Because these other platforms aren't as investor-focused as StockTwits they may lack the context like price, chart or video. Sending the response's body will allow the user of those other networks access to the finacial context of the message with a link back to the appropriate page. The Message ID can be used to create your own link to the message as a landing page. This comes in handy in the case of a Chart or Video where you might not want to create your own webpage or integrate the chart or video into your application.


Test console
Description
Parameter
string

The body of the message. This parameter should be URL-encoded or entire request sent as multipart/form-data for all characters to submit properly. Chracter count must be under 140

body

Required

number

The ID this message replies to, if any.

in_reply_to_message_id

Optional

string

Path or URL to file to be uploaded. File Formats accepted: JPG, PNG, GIF under 1MB

chart

Optional

string

A sentiment label for the message. Acceptable values: bullish, bearish, neutral. Defaults to neutral.

sentiment

Optional

HTTP 200 : message/like GET/messages/like.json
						{
  "response": {
    "status": 200
  },
  "message": {
    "id": 61,
    "body": "I sold $NQ_F",
    "created_at": "2012-10-08 21:42:32 UTC",
    "user": {
      "id": 1,
      "username": "howardlindzon",
      "name": "Howard Lindzon",
      "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
      "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
      "identity": "User",
      "classification": [

      ]
    },
    "source": {
      "id": 1,
      "title": "StockTwits",
      "url": "http://stocktwits.com"
    },
    "symbols": [
      {
        "id": 31,
        "symbol": "NQ_F",
        "title": "E-Mini NASDAQ 100 Futures",
      }
    ]
  }
}						
messages/like

Like a message on StockTwits as the authenticating user.


Test console
Description
Parameter
string

ID of the message you want to like for the authenticating user

id

Required

HTTP 200 : message GET/messages/show/{id}.json
						{
  "response": {
    "status": 200
  },
  "message": {
    "id": 31,
    "body": "something about $NQ_F",
    "created_at": "2012-10-08 21:40:22 UTC",
    "user": {
      "id": 2,
      "username": "ppearlman",
      "name": "Phil Pearlman",
      "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
      "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
      "identity": "User",
      "classification": [

      ]
    },
    "source": {
      "id": 1,
      "title": "StockTwits",
      "url": "http://stocktwits.com"
    },
    "symbols": [
      {
        "id": 31,
        "symbol": "NQ_F",
        "title": "E-Mini NASDAQ 100 Futures",
      }
    ],
    "entities": {
      "chart": {
        "thumb": "/chart_images/small/missing.png",
        "original": "/chart_images/original/missing.png"
      }
    }
  }
}						
messages/show

This shows the specified message details. This is used in a stand alone display. View the display guidelines


Test console
Description
Parameter
string

id

Required

boolean

Set to true to retrieve all meesages of the associated conversation.

conversation

Optional

string

Define your own callback function name, add this parameter as the value.

callback

Optional

HTTP 200 : message/like GET/messages/unlike.json
						{
  "response": {
    "status": 200
  },
  "message": {
    "id": 61,
    "body": "I sold $NQ_F",
    "created_at": "2012-10-08 21:42:32 UTC",
    "user": {
      "id": 1,
      "username": "howardlindzon",
      "name": "Howard Lindzon",
      "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
      "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
      "identity": "User",
      "classification": [

      ]
    },
    "source": {
      "id": 1,
      "title": "StockTwits",
      "url": "http://stocktwits.com"
    },
    "symbols": [
      {
        "id": 31,
        "symbol": "NQ_F",
        "title": "E-Mini NASDAQ 100 Futures",
      }
    ]
  }
}						
messages/unlike

Unlike a message on StockTwits as the authenticating user.


Test console
Description
Parameter
string

ID of the message you want to unlike for the authenticating user

id

Required

Streams

HTTP 200 : user GET/streams/direct.json
						{
  "response": {
    "status": 200
  },
  "user": {
    "id": 3,
    "username": "zerobeta",
    "name": "Justin Paterno",
    "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
    "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
    "identity": "Official",
    "classification": [
      "ir"
    ]
  },
  "cursor": {
    "more": true,
    "since": 40,
    "max": 42
  },
  "messages": [
    {
      "id": 40,
      "body": "I sold $NQ_F",
      "created_at": "2012-10-08 21:40:46 UTC",
      "user": {
        "id": 3,
        "username": "zerobeta",
        "name": "Justin Paterno",
        "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
        "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
        "identity": "Official",
        "classification": [
          "ir"
        ]
      },
      "source": {
        "id": 1,
        "title": "StockTwits",
        "url": "http://stocktwits.com"
      },
      "symbols": [
        {
          "id": 31,
          "symbol": "NQ_F",
          "title": "E-Mini NASDAQ 100 Futures",
        }
      ],
    
    },
    {
      "id": 41,
      "body": "long $TF_F",
      "created_at": "2012-10-08 21:40:46 UTC",
      "user": {
        "id": 3,
        "username": "zerobeta",
        "name": "Justin Paterno",
        "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
        "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
        "identity": "Official",
        "classification": [
          "ir"
        ]
      },
      "source": {
        "id": 1,
        "title": "StockTwits",
        "url": "http://stocktwits.com"
      },
      "symbols": [
        {
          "id": 32,
          "symbol": "TF_F",
          "title": "Russell 2000 Index Mini Futures",
        }
      ],
    
    },
    {
      "id": 42,
      "body": "short $ES_F",
      "created_at": "2012-10-08 21:40:46 UTC",
      "user": {
        "id": 3,
        "username": "zerobeta",
        "name": "Justin Paterno",
        "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
        "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
        "identity": "Official",
        "classification": [
          "ir"
        ]
      },
      "source": {
        "id": 1,
        "title": "StockTwits",
        "url": "http://stocktwits.com"
      },
      "symbols": [
        {
          "id": 30,
          "symbol": "ES_F",
          "title": "E-Mini S&P 500 Futures",
        }
      ]
    }
  ]
}						
streams/direct

Returns the most recent 30 direct messages sent to the authenticating user. These area all private messages sent and recieved.


Test console
Description
Parameter
number

Returns results with an ID greater than (more recent than) the specified ID.

since

Optional

number

Returns results with an ID less than (older than) or equal to the specified ID.

max

Optional

number

Default and max limit is 30. This limit must be a number under 30.
Example: 20

limit

Optional

string

Define your own callback function name, add this parameter as the value.

callback

Optional

HTTP 200 : user GET/streams/friends.json
						{
  "response": {
    "status": 200
  },
  "user": {
    "id": 3,
    "username": "zerobeta",
    "name": "Justin Paterno",
    "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
    "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
    "identity": "Official",
    "classification": [
      "ir"
    ]
  },
  "cursor": {
    "more": true,
    "since": 40,
    "max": 42
  },
  "messages": [
    {
      "id": 40,
      "body": "I sold $NQ_F",
      "created_at": "2012-10-08 21:40:46 UTC",
      "user": {
        "id": 3,
        "username": "zerobeta",
        "name": "Justin Paterno",
        "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
        "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
        "identity": "Official",
        "classification": [
          "ir"
        ]
      },
      "source": {
        "id": 1,
        "title": "StockTwits",
        "url": "http://stocktwits.com"
      },
      "symbols": [
        {
          "id": 31,
          "symbol": "NQ_F",
          "title": "E-Mini NASDAQ 100 Futures",
        }
      ],
    
    },
    {
      "id": 41,
      "body": "long $TF_F",
      "created_at": "2012-10-08 21:40:46 UTC",
      "user": {
        "id": 3,
        "username": "zerobeta",
        "name": "Justin Paterno",
        "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
        "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
        "identity": "Official",
        "classification": [
          "ir"
        ]
      },
      "source": {
        "id": 1,
        "title": "StockTwits",
        "url": "http://stocktwits.com"
      },
      "symbols": [
        {
          "id": 32,
          "symbol": "TF_F",
          "title": "Russell 2000 Index Mini Futures",
        }
      ],
    
    },
    {
      "id": 42,
      "body": "short $ES_F",
      "created_at": "2012-10-08 21:40:46 UTC",
      "user": {
        "id": 3,
        "username": "zerobeta",
        "name": "Justin Paterno",
        "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
        "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
        "identity": "Official",
        "classification": [
          "ir"
        ]
      },
      "source": {
        "id": 1,
        "title": "StockTwits",
        "url": "http://stocktwits.com"
      },
      "symbols": [
        {
          "id": 30,
          "symbol": "ES_F",
          "title": "E-Mini S&P 500 Futures",
        }
      ]
    }
  ]
}						
streams/friends

Returns the most recent 30 messages posted to the authenticating user's people stream of the users they follow.


Test console
Description
Parameter
number

Returns results with an ID greater than (more recent than) the specified ID.

since

Optional

number

Returns results with an ID less than (older than) or equal to the specified ID.

max

Optional

number

Default and max limit is 30. This limit must be a number under 30.
Example: 20

limit

Optional

string

Define your own callback function name, add this parameter as the value.

callback

Optional

string

Filter messages by links, charts, videos, or top.

filter

Optional

HTTP 200 : user GET/streams/home.json
						{
  "response": {
    "status": 200
  },
  "user": {
    "id": 3,
    "username": "zerobeta",
    "name": "Justin Paterno",
    "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
    "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
    "identity": "Official",
    "classification": [
      "ir"
    ]
  },
  "cursor": {
    "more": true,
    "since": 40,
    "max": 42
  },
  "messages": [
    {
      "id": 40,
      "body": "I sold $NQ_F",
      "created_at": "2012-10-08 21:40:46 UTC",
      "user": {
        "id": 3,
        "username": "zerobeta",
        "name": "Justin Paterno",
        "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
        "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
        "identity": "Official",
        "classification": [
          "ir"
        ]
      },
      "source": {
        "id": 1,
        "title": "StockTwits",
        "url": "http://stocktwits.com"
      },
      "symbols": [
        {
          "id": 31,
          "symbol": "NQ_F",
          "title": "E-Mini NASDAQ 100 Futures",
        }
      ],
    
    },
    {
      "id": 41,
      "body": "long $TF_F",
      "created_at": "2012-10-08 21:40:46 UTC",
      "user": {
        "id": 3,
        "username": "zerobeta",
        "name": "Justin Paterno",
        "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
        "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
        "identity": "Official",
        "classification": [
          "ir"
        ]
      },
      "source": {
        "id": 1,
        "title": "StockTwits",
        "url": "http://stocktwits.com"
      },
      "symbols": [
        {
          "id": 32,
          "symbol": "TF_F",
          "title": "Russell 2000 Index Mini Futures",
        }
      ],
    
    },
    {
      "id": 42,
      "body": "short $ES_F",
      "created_at": "2012-10-08 21:40:46 UTC",
      "user": {
        "id": 3,
        "username": "zerobeta",
        "name": "Justin Paterno",
        "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
        "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
        "identity": "Official",
        "classification": [
          "ir"
        ]
      },
      "source": {
        "id": 1,
        "title": "StockTwits",
        "url": "http://stocktwits.com"
      },
      "symbols": [
        {
          "id": 30,
          "symbol": "ES_F",
          "title": "E-Mini S&P 500 Futures",
        }
      ]
    }
  ]
}						
streams/home

Returns the most recent 30 messages posted to the authenticating user's home stream, which is made up of the users and stocks they follow.


Test console
Description
Parameter
number

Returns results with an ID greater than (more recent than) the specified ID

since

Optional

number

Returns results with an ID less than (older than) or equal to the specified ID.

max

Optional

number

Default and max limit is 30. This limit must be a number under 30.
Example: 20

limit

Optional

string

Define your own callback function name, add this parameter as the value.

callback

Optional

string

Filter messages by links, charts, videos, or top.

filter

Optional

HTTP 200 : user GET/streams/investor_relations.json
						{
  "response": {
    "status": 200
  },
  "user": {
    "id": 3,
    "username": "zerobeta",
    "name": "Justin Paterno",
    "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
    "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
    "identity": "Official",
    "classification": [
      "ir"
    ]
  },
  "cursor": {
    "more": true,
    "since": 40,
    "max": 42
  },
  "messages": [
    {
      "id": 40,
      "body": "I sold $NQ_F",
      "created_at": "2012-10-08 21:40:46 UTC",
      "user": {
        "id": 3,
        "username": "zerobeta",
        "name": "Justin Paterno",
        "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
        "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
        "identity": "Official",
        "classification": [
          "ir"
        ]
      },
      "source": {
        "id": 1,
        "title": "StockTwits",
        "url": "http://stocktwits.com"
      },
      "symbols": [
        {
          "id": 31,
          "symbol": "NQ_F",
          "title": "E-Mini NASDAQ 100 Futures",
        }
      ],
    
    },
    {
      "id": 41,
      "body": "long $TF_F",
      "created_at": "2012-10-08 21:40:46 UTC",
      "user": {
        "id": 3,
        "username": "zerobeta",
        "name": "Justin Paterno",
        "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
        "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
        "identity": "Official",
        "classification": [
          "ir"
        ]
      },
      "source": {
        "id": 1,
        "title": "StockTwits",
        "url": "http://stocktwits.com"
      },
      "symbols": [
        {
          "id": 32,
          "symbol": "TF_F",
          "title": "Russell 2000 Index Mini Futures",
        }
      ],
    
    },
    {
      "id": 42,
      "body": "short $ES_F",
      "created_at": "2012-10-08 21:40:46 UTC",
      "user": {
        "id": 3,
        "username": "zerobeta",
        "name": "Justin Paterno",
        "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
        "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
        "identity": "Official",
        "classification": [
          "ir"
        ]
      },
      "source": {
        "id": 1,
        "title": "StockTwits",
        "url": "http://stocktwits.com"
      },
      "symbols": [
        {
          "id": 30,
          "symbol": "ES_F",
          "title": "E-Mini S&P 500 Futures",
        }
      ]
    }
  ]
}						
streams/investor_relations

Returns the most recent 30 messages posted by verified Investor Relations customers.


Test console
Description
Parameter
number

Returns results with an ID greater than (more recent than) the specified ID.

since

Optional

number

Returns results with an ID less than (older than) or equal to the specified ID.

max

Optional

string

Default and max limit is 30. This limit must be a number under 30.
Example: 20

limit

Optional

string

Define your own callback function name, add this parameter as the value.

callback

Optional

HTTP 200 : user GET/streams/mentions.json
						{
  "response": {
    "status": 200
  },
  "user": {
    "id": 3,
    "username": "zerobeta",
    "name": "Justin Paterno",
    "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
    "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
    "identity": "Official",
    "classification": [
      "ir"
    ]
  },
  "cursor": {
    "more": true,
    "since": 40,
    "max": 42
  },
  "messages": [
    {
      "id": 40,
      "body": "I sold $NQ_F",
      "created_at": "2012-10-08 21:40:46 UTC",
      "user": {
        "id": 3,
        "username": "zerobeta",
        "name": "Justin Paterno",
        "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
        "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
        "identity": "Official",
        "classification": [
          "ir"
        ]
      },
      "source": {
        "id": 1,
        "title": "StockTwits",
        "url": "http://stocktwits.com"
      },
      "symbols": [
        {
          "id": 31,
          "symbol": "NQ_F",
          "title": "E-Mini NASDAQ 100 Futures",
        }
      ],
    
    },
    {
      "id": 41,
      "body": "long $TF_F",
      "created_at": "2012-10-08 21:40:46 UTC",
      "user": {
        "id": 3,
        "username": "zerobeta",
        "name": "Justin Paterno",
        "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
        "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
        "identity": "Official",
        "classification": [
          "ir"
        ]
      },
      "source": {
        "id": 1,
        "title": "StockTwits",
        "url": "http://stocktwits.com"
      },
      "symbols": [
        {
          "id": 32,
          "symbol": "TF_F",
          "title": "Russell 2000 Index Mini Futures",
        }
      ],
    
    },
    {
      "id": 42,
      "body": "short $ES_F",
      "created_at": "2012-10-08 21:40:46 UTC",
      "user": {
        "id": 3,
        "username": "zerobeta",
        "name": "Justin Paterno",
        "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
        "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
        "identity": "Official",
        "classification": [
          "ir"
        ]
      },
      "source": {
        "id": 1,
        "title": "StockTwits",
        "url": "http://stocktwits.com"
      },
      "symbols": [
        {
          "id": 30,
          "symbol": "ES_F",
          "title": "E-Mini S&P 500 Futures",
        }
      ]
    }
  ]
}						
streams/mentions

Returns the most recent 30 messages containing mentions of the authenticating user's handle. These are considered public replies


Test console
Description
Parameter
number

Returns results with an ID greater than (more recent than) the specified ID.

since

Optional

number

Returns results with an ID less than (older than) or equal to the specified ID.

max

Optional

number

Default and max limit is 30. This limit must be a number under 30.
Example: 20

limit

Optional

string

Define your own callback function name, add this parameter as the value.

callback

Optional

HTTP 200 : symbol GET/streams/symbol/{id}.json
						{
  "response": {
    "status": 200
  },
  "symbol": {
    "id": 17,
    "symbol": "JOY",
    "title": "Joy Global, Inc.",
  },
  "cursor": {
    "more": true,
    "since": 49,
    "max": 51
  },
  "messages": [
    {
      "id": 49,
      "body": "short $JOY",
      "created_at": "2012-10-08 21:41:38 UTC",
      "user": {
        "id": 2,
        "username": "ppearlman",
        "name": "Phil Pearlman",
        "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
        "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
        "identity": "User",
        "classification": [
          "suggested"
        ]
      },
      "source": {
        "id": 1,
        "title": "StockTwits",
        "url": "http://stocktwits.com"
      },
      "symbols": [
        {
          "id": 17,
          "symbol": "JOY",
          "title": "Joy Global, Inc.",
        }
      ],
    
    },
    {
      "id": 50,
      "body": "an idea about a $JOY",
      "created_at": "2012-10-08 21:41:38 UTC",
      "user": {
        "id": 2,
        "username": "ppearlman",
        "name": "Phil Pearlman",
        "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
        "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
        "identity": "User",
        "classification": [
          "suggested"
        ]
      },
      "source": {
        "id": 1,
        "title": "StockTwits",
        "url": "http://stocktwits.com"
      },
      "symbols": [
        {
          "id": 17,
          "symbol": "JOY",
          "title": "Joy Global, Inc.",
        }
      ],
    
    },
    {
      "id": 51,
      "body": "more ideas about $JOY",
      "created_at": "2012-10-08 21:41:38 UTC",
      "user": {
        "id": 2,
        "username": "ppearlman",
        "name": "Phil Pearlman",
        "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
        "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
        "identity": "User",
        "classification": [
          "suggested"
        ]
      },
      "source": {
        "id": 1,
        "title": "StockTwits",
        "url": "http://stocktwits.com"
      },
      "symbols": [
        {
          "id": 17,
          "symbol": "JOY",
          "title": "Joy Global, Inc.",
        }
      ]
    }
  ]
}						
streams/symbol

Returns the most recent 30 messages for the specified symbol.


Test console
Description
Parameter
string

Ticker symbol, Stock ID, or RIC code of the symbol
Example: AAPL

id

Required

number

Returns results with an ID greater than (more recent than) the specified ID

since

Optional

number

Returns results with an ID less than (older than) or equal to the specified ID

max

Optional

number

Default and max limit is 30. This limit must be a number under 30
Example: 20

limit

Optional

string

Define your own callback function name, add this parameter as the value.

callback

Optional

string

Filter messages by links, charts, videos, or top.

filter

Optional

HTTP 200 : user GET/streams/user/{id}.json
						{
  "response": {
    "status": 200
  },
  "user": {
    "id": 3,
    "username": "zerobeta",
    "name": "Justin Paterno",
    "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
    "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
    "identity": "Official",
    "classification": [
      "ir"
    ]
  },
  "cursor": {
    "more": true,
    "since": 40,
    "max": 42
  },
  "messages": [
    {
      "id": 40,
      "body": "I sold $NQ_F",
      "created_at": "2012-10-08 21:40:46 UTC",
      "user": {
        "id": 3,
        "username": "zerobeta",
        "name": "Justin Paterno",
        "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
        "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
        "identity": "Official",
        "classification": [
          "ir"
        ]
      },
      "source": {
        "id": 1,
        "title": "StockTwits",
        "url": "http://stocktwits.com"
      },
      "symbols": [
        {
          "id": 31,
          "symbol": "NQ_F",
          "title": "E-Mini NASDAQ 100 Futures",
        }
      ],
    
    },
    {
      "id": 41,
      "body": "long $TF_F",
      "created_at": "2012-10-08 21:40:46 UTC",
      "user": {
        "id": 3,
        "username": "zerobeta",
        "name": "Justin Paterno",
        "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
        "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
        "identity": "Official",
        "classification": [
          "ir"
        ]
      },
      "source": {
        "id": 1,
        "title": "StockTwits",
        "url": "http://stocktwits.com"
      },
      "symbols": [
        {
          "id": 32,
          "symbol": "TF_F",
          "title": "Russell 2000 Index Mini Futures",
        }
      ],
    
    },
    {
      "id": 42,
      "body": "short $ES_F",
      "created_at": "2012-10-08 21:40:46 UTC",
      "user": {
        "id": 3,
        "username": "zerobeta",
        "name": "Justin Paterno",
        "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
        "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
        "identity": "Official",
        "classification": [
          "ir"
        ]
      },
      "source": {
        "id": 1,
        "title": "StockTwits",
        "url": "http://stocktwits.com"
      },
      "symbols": [
        {
          "id": 30,
          "symbol": "ES_F",
          "title": "E-Mini S&P 500 Futures",
        }
      ]
    }
  ]
}						
streams/user

Returns the most recent 30 messages for the specified user. Includes user object in response.


Test console
Description
Parameter
string

User ID or Username of the stream's user you want to show
Example: zerobeta

id

Required

number

Returns results with an ID greater than (more recent than) the specified ID.

since

Optional

number

Returns results with an ID less than (older than) or equal to the specified ID.

max

Optional

number

Default and max limit is 30. This limit must be a number under 30.

limit

Optional

string

Define your own callback function name, add this parameter as the value.

callback

Optional

string

Filter messages by links, charts, or videos.

filter

Optional

HTTP 200 : user GET/streams/watchlist/{id}.json
						{
  "response": {
    "status": 200
  },
  "user": {
    "id": 3,
    "username": "zerobeta",
    "name": "Justin Paterno",
    "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
    "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
    "identity": "Official",
    "classification": [
      "ir"
    ]
  },
  "cursor": {
    "more": true,
    "since": 40,
    "max": 42
  },
  "messages": [
    {
      "id": 40,
      "body": "I sold $NQ_F",
      "created_at": "2012-10-08 21:40:46 UTC",
      "user": {
        "id": 3,
        "username": "zerobeta",
        "name": "Justin Paterno",
        "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
        "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
        "identity": "Official",
        "classification": [
          "ir"
        ]
      },
      "source": {
        "id": 1,
        "title": "StockTwits",
        "url": "http://stocktwits.com"
      },
      "symbols": [
        {
          "id": 31,
          "symbol": "NQ_F",
          "title": "E-Mini NASDAQ 100 Futures",
        }
      ],
    
    },
    {
      "id": 41,
      "body": "long $TF_F",
      "created_at": "2012-10-08 21:40:46 UTC",
      "user": {
        "id": 3,
        "username": "zerobeta",
        "name": "Justin Paterno",
        "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
        "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
        "identity": "Official",
        "classification": [
          "ir"
        ]
      },
      "source": {
        "id": 1,
        "title": "StockTwits",
        "url": "http://stocktwits.com"
      },
      "symbols": [
        {
          "id": 32,
          "symbol": "TF_F",
          "title": "Russell 2000 Index Mini Futures",
        }
      ],
    
    },
    {
      "id": 42,
      "body": "short $ES_F",
      "created_at": "2012-10-08 21:40:46 UTC",
      "user": {
        "id": 3,
        "username": "zerobeta",
        "name": "Justin Paterno",
        "avatar_url": "http://avatars.stocktwits.com/images/default_avatar_thumb.jpg",
        "avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/images/default_avatar_thumb.jpg",
        "identity": "Official",
        "classification": [
          "ir"
        ]
      },
      "source": {
        "id": 1,
        "title": "StockTwits",
        "url": "http://stocktwits.com"
      },
      "symbols": [
        {
          "id": 30,
          "symbol": "ES_F",
          "title": "E-Mini S&P 500 Futures",
        }
      ]
    }
  ]
}						
streams/watchlist

Returns the most recent 30 messages for the specified watch list for the authenticating user. The watch list is a private list of all the symbols a user is watching.


Test console
Description
Parameter
string

ID of the watch list you want to show from the authenticating user

id

Required

number

Returns results with an ID greater than (more recent than) the specified ID.

since

Optional

number

Returns results with an ID less than (older than) or equal to the specified ID.

max

Optional

number

Default and max limit is 30. This limit must be a number under 30.
Example: 20

limit

Optional

string

Define your own callback function name, add this parameter as the value.

callback

Optional

Consume this API completely for free!


By joining the mashape API marketplace you can start using StockTwits API today!

Login to your account or signup: Create Account

or
   Signup with GitHub

By signing up you agree to our terms of service.