Sign in to StockTwits X
Sign in to StockTwits X
Don't have an account? Join StockTwits
Sign up X
Join StockTwits
- Developer
- Documentation
- Methods
API Methods
- user
- symbol
- investor_relations
- home
- friends
- mentions
- direct
- direct_sent
- direct_received
- watchlist
- all
- charts
- equities
- forex
- futures
- private_companies
- suggested
- symbols
- trending
- sectors
- conversation
Streams
- search
- search/symbols
- search/users
Search
- watchlists
- create
- update
- destroy
- show
- symbols/create
- symbols/destroy
WatchLists
- symbols
- symbols/equities
Trending
URL
Method Information
| Rate Limited? | |
| Requires Authentication? | |
| Requires Partner-Level Access? | |
| Pagination? | |
| Response Formats: | |
| HTTP Methods: |
Usage Examples
Response
StockTwits API Console
Please Authenticate the developer console with your registered applicaiton in order to use and test the API methods.
Allows an application to request user authorization. There are two different flow options depending if your application is client side or server side.
Learn about the authentication flow
https://api.stocktwits.com/api/2/oauth/authorize
No
No
No
JSON
POST
Parameters
| client_id: | The consumer key for the OAuth client |
| response_type: | The response type for the OAuth flow. Valid types are code and token |
| redirect_uri: | The URI where StockTwits will redirect the user for authorization |
| scope: | A comma-delimited list of scope permissions |
| prompt: | Set to 1 to always prompt for authorization |
cURL [ about cURL ] // Token example curl -X GET -u <username> -p https://api.stocktwits.com/api/2/oauth/authorize -d 'client_id=<client id>&response_type=token&redirect_uri=http://www.example.com&scope=read,watch_lists,publish_messages,publish_watch_lists,follow_users,follow_stocks' // Code example curl -X GET https://api.stocktwits.com/api/2/oauth/authorize -d 'client_id=<client id>&response_type=code&redirect_uri=http://www.example.com&scope=read,watch_lists,publish_messages,publish_watch_lists,follow_users,follow_stocks'
// Token response <html> <body>You are being <a href="http://www.example.com#access_token=<access_token>">redirected</a>.</body> </html> // Code response <html> <body>You are being <a href="https://stocktwits.com/api/2/oauth/signin?client_id=<client id>&redirect_uri=http%3A%2F%2Fwww.example.com&response_type=code">redirected</a>.</body> </html>
Returns a user authorization token to make authenticated API calls.
Learn about how tokens are used
https://api.stocktwits.com/api/2/oauth/token
No
No
No
JSON
POST
Parameters
| client_id: | The consumer key for the OAuth client |
| grant_type: | The grant type requested. Valid types are authorization_code and refresh_token |
| client_secret: | The consumer secret for the client application |
| redirect_uri: | The URI where StockTwits will redirect the user for authorization |
| code: | The authorization code returned in the Code server flow |
cURL [ about cURL ] curl -X POST https://api.stocktwits.com/api/2/oauth/token -d 'client_id=<client id>&client_secret=<client secret>&code=<code>&grant_type=authorization_code&redirect_uri=http://www.example.com'
{
"user_id":1,
"access_token":"<access token>",
"scope":"read",
"username":"userabc"
}
Returns the most recent 30 messages for the specified user. Includes user object in response.
View the display guidelines
The extended metadata in the API response below is only available through Partner-Level Access
https://api.stocktwits.com/api/2/streams/user/:id.json
No
No
JSON
GET
Parameters
| id: | User ID or Username of the stream's user you want to show (Required) |
| since: | Returns results with an ID greater than (more recent than) the specified ID. |
| max: | Returns results with an ID less than (older than) or equal to the specified ID. |
| limit: | Default and max limit is 30. This limit must be a number under 30. |
| callback: | Define your own callback function name, add this parameter as the value. |
| filter: | Filter messages by links, charts, or videos. (Optional) |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/streams/user/170.json curl -X GET https://api.stocktwits.com/api/2/streams/user/howardlindzon.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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Product at StockTwits",
"website_url": "http://justinpaterno.com",
"trading_strategy": {
"assets_frequently_traded": [
"Equities",
"Options",
"Forex"
],
"approach": "Growth",
"holding_period": "Position Trader",
"experience": "Intermediate"
}
},
"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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Product at StockTwits",
"website_url": "http://justinpaterno.com",
"trading_strategy": {
"assets_frequently_traded": [
"Equities",
"Options",
"Forex"
],
"approach": "Growth",
"holding_period": "Position Trader",
"experience": "Intermediate"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 31,
"symbol": "NQ_F",
"title": "E-Mini NASDAQ 100 Futures",
"exchange": "CME",
"sector": null,
"industry": null,
"trending": false
}
],
"entities": {
"sentiment": null
}
},
{
"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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Product at StockTwits",
"website_url": "http://justinpaterno.com",
"trading_strategy": {
"assets_frequently_traded": [
"Equities",
"Options",
"Forex"
],
"approach": "Growth",
"holding_period": "Position Trader",
"experience": "Intermediate"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 32,
"symbol": "TF_F",
"title": "Russell 2000 Index Mini Futures",
"exchange": "ICE",
"sector": null,
"industry": null,
"trending": false
}
],
"entities": {
"sentiment": null
}
},
{
"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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Product at StockTwits",
"website_url": "http://justinpaterno.com",
"trading_strategy": {
"assets_frequently_traded": [
"Equities",
"Options",
"Forex"
],
"approach": "Growth",
"holding_period": "Position Trader",
"experience": "Intermediate"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 30,
"symbol": "ES_F",
"title": "E-Mini S&P 500 Futures",
"exchange": "CME",
"sector": null,
"industry": null,
"trending": false
}
],
"entities": {
"sentiment": null
}
}
]
}
Returns the most recent 30 messages for the specified symbol. Includes symbol object in response.
View the display guidelines
The extended metadata in the API response below is only available through Partner-Level Access
https://api.stocktwits.com/api/2/streams/symbol/:id.json
https://api.stocktwits.com/api/2/streams/symbol/ric/:id.json
https://api.stocktwits.com/api/2/streams/symbol/ric/:id.json
No
No
JSON
GET
Parameters
| id: | Ticker symbol, Stock ID, or RIC code of the symbol (Required) |
| since: | Returns results with an ID greater than (more recent than) the specified ID. |
| max: | Returns results with an ID less than (older than) or equal to the specified ID. |
| limit: | Default and max limit is 30. This limit must be a number under 30. |
| callback: | Define your own callback function name, add this parameter as the value. |
| filter: | Filter messages by links, charts, videos, or top. (Optional) |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/streams/symbol/AAPL.json
{
"response": {
"status": 200
},
"symbol": {
"id": 17,
"symbol": "JOY",
"title": "Joy Global, Inc.",
"exchange": "NYSE",
"sector": "Industrial Goods",
"industry": "REIT - Residential"
},
"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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 17,
"symbol": "JOY",
"title": "Joy Global, Inc.",
"exchange": "NYSE",
"sector": "Industrial Goods",
"industry": "REIT - Residential",
"trending": false
}
],
"entities": {
"sentiment": null
}
},
{
"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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 17,
"symbol": "JOY",
"title": "Joy Global, Inc.",
"exchange": "NYSE",
"sector": "Industrial Goods",
"industry": "REIT - Residential",
"trending": false
}
],
"entities": {
"sentiment": null
}
},
{
"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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 17,
"symbol": "JOY",
"title": "Joy Global, Inc.",
"exchange": "NYSE",
"sector": "Industrial Goods",
"industry": "REIT - Residential",
"trending": false
}
],
"entities": {
"sentiment": null
}
}
]
}
Returns the most recent 30 messages for the specified list of symbols. Up to 10 symbols allowed. View the display guidelines
This API end-point is only available through Partner-Level Access
https://api.stocktwits.com/api/2/streams/symbols.json
JSON
GET
Parameters
| symbols: | List of multiple Ticker symbols or Stock IDs. Max 10 (Required) |
| since: | Returns results with an ID greater than (more recent than) the specified ID. |
| max: | Returns results with an ID less than (older than) or equal to the specified ID. |
| limit: | Default and max limit is 30. This limit must be a number under 30. |
| callback: | Define your own callback function name, add this parameter as the value. |
| filter: | Filter messages by links, charts, videos, or top. (Optional) |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/streams/symbols.json?access_token=<access_token> -d symbols=AAPL,MSFT
{
"response": {
"status": 200
},
"cursor": {
"more": true,
"since": 16,
"max": 18
},
"symbols": [
[
{
"id": 32,
"symbol": "TF_F",
"title": "Russell 2000 Index Mini Futures",
"exchange": "ICE",
"sector": null,
"industry": null
},
{
"id": 31,
"symbol": "NQ_F",
"title": "E-Mini NASDAQ 100 Futures",
"exchange": "CME",
"sector": null,
"industry": null
},
{
"id": 30,
"symbol": "ES_F",
"title": "E-Mini S&P 500 Futures",
"exchange": "CME",
"sector": null,
"industry": null
}
],
{
"more": true,
"since": 16,
"max": 18
}
],
"messages": [
{
"id": 16,
"body": "more ideas about $TF_F",
"created_at": "2012-10-08 21:39:15 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": [
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 32,
"symbol": "TF_F",
"title": "Russell 2000 Index Mini Futures",
"exchange": "ICE",
"sector": null,
"industry": null,
"trending": false
}
],
"entities": {
"sentiment": null
}
},
{
"id": 17,
"body": "something about $ES_F",
"created_at": "2012-10-08 21:39:16 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": [
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 30,
"symbol": "ES_F",
"title": "E-Mini S&P 500 Futures",
"exchange": "CME",
"sector": null,
"industry": null,
"trending": false
}
],
"entities": {
"sentiment": null
}
},
{
"id": 18,
"body": "I bought $NQ_F",
"created_at": "2012-10-08 21:39:16 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": [
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 31,
"symbol": "NQ_F",
"title": "E-Mini NASDAQ 100 Futures",
"exchange": "CME",
"sector": null,
"industry": null,
"trending": false
}
],
"entities": {
"sentiment": null
}
}
]
}
Returns the most recent 30 messages for all non-private symbols.
View the display guidelines
This API end-point is only available through Partner-Level Access
https://api.stocktwits.com/api/2/streams/all.json
JSON
GET
Parameters
| since: | Returns results with an ID greater than (more recent than) the specified ID. |
| max: | Returns results with an ID less than (older than) or equal to the specified ID. |
| limit: | Default and max limit is 30. This limit must be a number under 30. |
| callback: | Define your own callback function name, add this parameter as the value. |
| filter: | Filter messages by links, charts, videos, or top. (Optional) |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/streams/all.json?access_token=<access_token>
{
"response": {
"status": 200
},
"cursor": {
"more": true,
"since": 64,
"max": 66
},
"messages": [
{
"id": 64,
"body": "an idea about a $JOY",
"created_at": "2012-10-08 21:42:33 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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 17,
"symbol": "JOY",
"title": "Joy Global, Inc.",
"exchange": "NYSE",
"sector": "Industrial Goods",
"industry": "REIT - Residential",
"trending": false
}
],
"entities": {
"sentiment": null
}
},
{
"id": 65,
"body": "more ideas about $GOOG",
"created_at": "2012-10-08 21:42:33 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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 15,
"symbol": "GOOG",
"title": "Google Inc.",
"exchange": "NASDAQ",
"sector": "Technology",
"industry": "Other",
"trending": false
}
],
"entities": {
"sentiment": null
}
},
{
"id": 66,
"body": "something about $ARR",
"created_at": "2012-10-08 21:42:33 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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 16,
"symbol": "ARR",
"title": "ARMOUR Residential REIT, Inc.",
"exchange": "NYSE",
"sector": "Financial",
"industry": "Internet Information Providers",
"trending": false
}
],
"entities": {
"sentiment": null
}
}
]
}
Returns the most recent 30 messages for forex symbols. example $EURUSD
View the display guidelines
This API end-point is only available through Partner-Level Access
https://api.stocktwits.com/api/2/streams/forex.json
JSON
GET
Parameters
| since: | Returns results with an ID greater than (more recent than) the specified ID. |
| max: | Returns results with an ID less than (older than) or equal to the specified ID. |
| limit: | Default and max limit is 30. This limit must be a number under 30. |
| callback: | Define your own callback function name, add this parameter as the value. |
| filter: | Filter messages by links, charts, videos, or top. (Optional) |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/streams/forex.json?access_token=<access_token>
{
"response": {
"status": 200
},
"cursor": {
"more": true,
"since": 4,
"max": 6
},
"messages": [
{
"id": 4,
"body": "I bought $USDJPY",
"created_at": "2012-10-08 21:38:47 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": [
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 21,
"symbol": "USDJPY",
"title": "US Dollar / Japanese Yen",
"exchange": "FX",
"sector": null,
"industry": null,
"trending": false
}
],
"entities": {
"sentiment": null
}
},
{
"id": 5,
"body": "I sold $EURUSD",
"created_at": "2012-10-08 21:38:47 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": [
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 19,
"symbol": "EURUSD",
"title": "Euro / US Dollar",
"exchange": "FX",
"sector": null,
"industry": null,
"trending": false
}
],
"entities": {
"sentiment": null
}
},
{
"id": 6,
"body": "long $GBPUSD",
"created_at": "2012-10-08 21:38:47 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": [
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 20,
"symbol": "GBPUSD",
"title": "British Pound / US Dollar",
"exchange": "FX",
"sector": null,
"industry": null,
"trending": false
}
],
"entities": {
"sentiment": null
}
}
]
}
Returns the most recent 30 messages for futures symbols. example $ES_F
View the display guidelines
This API end-point is only available through Partner-Level Access
https://api.stocktwits.com/api/2/streams/futures.json
JSON
GET
Parameters
| since: | Returns results with an ID greater than (more recent than) the specified ID. |
| max: | Returns results with an ID less than (older than) or equal to the specified ID. |
| limit: | Default and max limit is 30. This limit must be a number under 30. |
| callback: | Define your own callback function name, add this parameter as the value. |
| filter: | Filter messages by links, charts, videos, or top. (Optional) |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/streams/futures.json?access_token=<access_token>
{
"response": {
"status": 200
},
"cursor": {
"more": true,
"since": 55,
"max": 57
},
"messages": [
{
"id": 55,
"body": "long $TF_F",
"created_at": "2012-10-08 21:42:12 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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 32,
"symbol": "TF_F",
"title": "Russell 2000 Index Mini Futures",
"exchange": "ICE",
"sector": null,
"industry": null,
"trending": false
}
],
"entities": {
"sentiment": null
}
},
{
"id": 56,
"body": "short $ES_F",
"created_at": "2012-10-08 21:42:12 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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 30,
"symbol": "ES_F",
"title": "E-Mini S&P 500 Futures",
"exchange": "CME",
"sector": null,
"industry": null,
"trending": false
}
],
"entities": {
"sentiment": null
}
},
{
"id": 57,
"body": "an idea about a $NQ_F",
"created_at": "2012-10-08 21:42:12 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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 31,
"symbol": "NQ_F",
"title": "E-Mini NASDAQ 100 Futures",
"exchange": "CME",
"sector": null,
"industry": null,
"trending": false
}
],
"entities": {
"sentiment": null
}
}
]
}
Returns the most recent 30 messages that include charts. Charts can come in two forms either image file or video file.
View the display guidelines
https://api.stocktwits.com/api/2/streams/charts.json
No
No
JSON
GET
Parameters
| since: | Returns results with an ID greater than (more recent than) the specified ID. |
| max: | Returns results with an ID less than (older than) or equal to the specified ID. |
| limit: | Default and max limit is 30. This limit must be a number under 30. |
| callback: | Define your own callback function name, add this parameter as the value. |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/streams/charts.json?access_token=<access_token>
{
"response": {
"status": 200
},
"cursor": {
"more": true,
"since": 37,
"max": 39
},
"messages": [
{
"id": 37,
"body": "more ideas about $JOY",
"created_at": "2012-10-08 21:40:33 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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 17,
"symbol": "JOY",
"title": "Joy Global, Inc.",
"exchange": "NYSE",
"sector": "Industrial Goods",
"industry": "REIT - Residential",
"trending": false
}
],
"entities": {
"chart": {
"thumb": "/chart_images/small/missing.png",
"original": "/chart_images/original/missing.png"
},
"sentiment": null
}
},
{
"id": 38,
"body": "something about $ARR",
"created_at": "2012-10-08 21:40:33 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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 16,
"symbol": "ARR",
"title": "ARMOUR Residential REIT, Inc.",
"exchange": "NYSE",
"sector": "Financial",
"industry": "Internet Information Providers",
"trending": false
}
],
"entities": {
"chart": {
"thumb": "/chart_images/small/missing.png",
"original": "/chart_images/original/missing.png"
},
"sentiment": null
}
},
{
"id": 39,
"body": "I bought $JOY",
"created_at": "2012-10-08 21:40:33 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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 17,
"symbol": "JOY",
"title": "Joy Global, Inc.",
"exchange": "NYSE",
"sector": "Industrial Goods",
"industry": "REIT - Residential",
"trending": false
}
],
"entities": {
"chart": {
"thumb": "/chart_images/small/missing.png",
"original": "/chart_images/original/missing.png"
},
"sentiment": null
}
}
]
}
Returns the most recent 30 messages from our suggested users, a curated list of quality StockTwits contributors.
View the display guidelines
https://api.stocktwits.com/api/2/streams/suggested.json
No
No
JSON
GET
Parameters
| since: | Returns results with an ID greater than (more recent than) the specified ID. |
| max: | Returns results with an ID less than (older than) or equal to the specified ID. |
| limit: | Default and max limit is 30. This limit must be a number under 30. |
| callback: | Define your own callback function name, add this parameter as the value. |
| filter: | Filter messages by links, charts, videos, or top. (Optional) |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/streams/suggested.json?access_token=<access_token>
{
"response": {
"status": 200
},
"cursor": {
"more": true,
"since": 34,
"max": 36
},
"messages": [
{
"id": 34,
"body": "long $JOY",
"created_at": "2012-10-08 21:40:23 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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 17,
"symbol": "JOY",
"title": "Joy Global, Inc.",
"exchange": "NYSE",
"sector": "Industrial Goods",
"industry": "REIT - Residential",
"trending": false
}
],
"entities": {
"sentiment": null
}
},
{
"id": 35,
"body": "short $GOOG",
"created_at": "2012-10-08 21:40:23 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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 15,
"symbol": "GOOG",
"title": "Google Inc.",
"exchange": "NASDAQ",
"sector": "Technology",
"industry": "Other",
"trending": false
}
],
"entities": {
"sentiment": null
}
},
{
"id": 36,
"body": "an idea about a $ARR",
"created_at": "2012-10-08 21:40:23 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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 16,
"symbol": "ARR",
"title": "ARMOUR Residential REIT, Inc.",
"exchange": "NYSE",
"sector": "Financial",
"industry": "Internet Information Providers",
"trending": false
}
],
"entities": {
"sentiment": null
}
}
]
}
Returns the most recent 30 messages containing equity symbols. This will not include futures or forex messages.
View the display guidelines
This API end-point is only available through Partner-Level Access
https://api.stocktwits.com/api/2/streams/equities.json
JSON
GET
Parameters
| since: | Returns results with an ID greater than (more recent than) the specified ID. |
| max: | Returns results with an ID less than (older than) or equal to the specified ID. |
| limit: | Default and max limit is 30. This limit must be a number under 30. |
| callback: | Define your own callback function name, add this parameter as the value. |
| filter: | Filter messages by links, charts, videos, or top. (Optional) |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/streams/equities.json?access_token=<access_token>
{
"response": {
"status": 200
},
"cursor": {
"more": true,
"since": 67,
"max": 69
},
"messages": [
{
"id": 67,
"body": "I bought $JOY",
"created_at": "2012-10-08 21:42:44 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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 17,
"symbol": "JOY",
"title": "Joy Global, Inc.",
"exchange": "NYSE",
"sector": "Industrial Goods",
"industry": "REIT - Residential",
"trending": false
}
],
"entities": {
"sentiment": null
}
},
{
"id": 68,
"body": "I sold $GOOG",
"created_at": "2012-10-08 21:42:45 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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 15,
"symbol": "GOOG",
"title": "Google Inc.",
"exchange": "NASDAQ",
"sector": "Technology",
"industry": "Other",
"trending": false
}
],
"entities": {
"sentiment": null
}
},
{
"id": 69,
"body": "long $ARR",
"created_at": "2012-10-08 21:42:45 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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 16,
"symbol": "ARR",
"title": "ARMOUR Residential REIT, Inc.",
"exchange": "NYSE",
"sector": "Financial",
"industry": "Internet Information Providers",
"trending": false
}
],
"entities": {
"sentiment": null
}
}
]
}
Returns the most recent 30 messages containing private symbols (example: $TWIT)
View the display guidelines
This API end-point is only available through Partner-Level Access
https://api.stocktwits.com/api/2/streams/private_companies.json
JSON
GET
Parameters
| since: | Returns results with an ID greater than (more recent than) the specified ID. |
| max: | Returns results with an ID less than (older than) or equal to the specified ID. |
| limit: | Default and max limit is 30. This limit must be a number under 30. |
| callback: | Define your own callback function name, add this parameter as the value. |
| filter: | Filter messages by links, charts, videos, or top. (Optional) |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/streams/private_companies.json?access_token=<access_token>
{
"response": {
"status": 200
},
"cursor": {
"more": true,
"since": 43,
"max": 45
},
"messages": [
{
"id": 43,
"body": "an idea about a $SQUARE",
"created_at": "2012-10-08 21:41:00 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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 28,
"symbol": "SQUARE",
"title": "Square",
"exchange": "PRIVATE",
"sector": null,
"industry": null,
"trending": false
}
],
"entities": {
"sentiment": null
}
},
{
"id": 44,
"body": "more ideas about $HULU",
"created_at": "2012-10-08 21:41:00 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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 26,
"symbol": "HULU",
"title": "Hulu",
"exchange": "PRIVATE",
"sector": null,
"industry": null,
"trending": false
}
],
"entities": {
"sentiment": null
}
},
{
"id": 45,
"body": "something about $4SQ",
"created_at": "2012-10-08 21:41:00 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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 27,
"symbol": "4SQ",
"title": "Foursquare",
"exchange": "PRIVATE",
"sector": null,
"industry": null,
"trending": false
}
],
"entities": {
"sentiment": null
}
}
]
}
This returns the most recent 30 messages of the passed sector path. A sector file with all the available sectors can be
downloaded here
.
View the display guidelines
This API end-point is only available through Partner-Level Access
https://api.stocktwits.com/api/2/streams/sectors/:sector_path.json
JSON
GET
Parameters
| since: | Returns results with an ID greater than (more recent than) the specified ID. |
| max: | Returns results with an ID less than (older than) or equal to the specified ID. |
| limit: | Default and max limit is 30. This limit must be a number under 30. |
| callback: | Define your own callback function name, add this parameter as the value. |
| filter: | Filter messages by links, charts, videos, or top. (Optional) |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/streams/sectors/technology.json?access_token=<access_token>
{
"response": {
"status": 200
},
"cursor": {
"more": true,
"since": 25,
"max": 27
},
"messages": [
{
"id": 25,
"body": "I bought $JOY",
"created_at": "2012-10-08 21:39:48 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": [
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 17,
"symbol": "JOY",
"title": "Joy Global, Inc.",
"exchange": "NYSE",
"sector": "Industrial Goods",
"industry": "REIT - Residential",
"trending": false
}
],
"entities": {
"sentiment": null
}
},
{
"id": 26,
"body": "I sold $GOOG",
"created_at": "2012-10-08 21:39:49 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": [
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 15,
"symbol": "GOOG",
"title": "Google Inc.",
"exchange": "NASDAQ",
"sector": "Technology",
"industry": "Other",
"trending": false
}
],
"entities": {
"sentiment": null
}
},
{
"id": 27,
"body": "long $ARR",
"created_at": "2012-10-08 21:39:49 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": [
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 16,
"symbol": "ARR",
"title": "ARMOUR Residential REIT, Inc.",
"exchange": "NYSE",
"sector": "Financial",
"industry": "Internet Information Providers",
"trending": false
}
],
"entities": {
"sentiment": null
}
}
]
}
Returns the most recent 30 messages for the specified conversation.
View the display guidelines
View the display guidelines
The extended metadata in the API response below is only available through Partner-Level Access
https://api.stocktwits.com/api/2/streams/conversation/:id.json
No
No
JSON
GET
Parameters
| id: | The message ID of the parent message to a conversation. (Required) |
| since: | Returns results with an ID greater than (more recent than) the specified ID. |
| max: | Returns results with an ID less than (older than) or equal to the specified ID. |
| limit: | Default and max limit is 30. This limit must be a number under 30. |
| callback: | Define your own callback function name, add this parameter as the value. |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/streams/conversation/10349526.json
{
"response": {
"status": 200
},
"cursor": {
"more": false,
"max": 10349931,
"since": 10349977
},
"parent": {
"id": 10349526,
"body": "adding back the $GOOG i sold friday at $594",
"created_at": "2012-11-05T14:54:48Z",
"user": {
"id": 5,
"username": "howardlindzon",
"name": "Howard Lindzon",
"avatar_url": "http://avatars.stocktwits.com/production/5/thumb-1347665796.png",
"avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/production/5/thumb-1347665796.png",
"identity": "User",
"classification": [
"suggested"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Founder and CEO of Stocktwits, Founder of Wallstrip (Acquired by CBS), Managing Member of Lindzon Capital Partners (Hedge Fund) and Managing Member of Social Leverage (an early stage web holding company) ...I have lot's of ideas.",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
"Options",
"Forex"
],
"approach": "Momentum",
"holding_period": "Swing Trader",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 2044,
"symbol": "GOOG",
"title": "Google Inc.",
"exchange": "NYSE",
"sector": "Industrial Goods",
"industry": "REIT - Residential",
"trending": false
}
],
"conversation": {
"parent_message_id": 10349526,
"in_reply_to_message_id": null,
"parent": true,
"replies": 2
},
"entities": {
"sentiment": null
}
},
"messages": [
{
"id": 10349977,
"body": "woops - i meant sold at $694...on stream noted. thx",
"created_at": "2012-11-05T15:05:25Z",
"user": {
"id": 5,
"username": "howardlindzon",
"name": "Howard Lindzon",
"avatar_url": "http://avatars.stocktwits.com/production/5/thumb-1347665796.png",
"avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/production/5/thumb-1347665796.png",
"identity": "User",
"classification": [
"suggested"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Founder and CEO of Stocktwits, Founder of Wallstrip (Acquired by CBS), Managing Member of Lindzon Capital Partners (Hedge Fund) and Managing Member of Social Leverage (an early stage web holding company) ...I have lot's of ideas.",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
"Options",
"Forex"
],
"approach": "Momentum",
"holding_period": "Swing Trader",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"conversation": {
"parent_message_id": 10349526,
"in_reply_to_message_id": 10349526,
"parent": false,
"replies": 2
},
"entities": {
"sentiment": null
}
},
{
"id": 10349931,
"body": "@howardlindzon That's hell of a tread! LOL $694",
"created_at": "2012-11-05T15:04:18Z",
"user": {
"id": 61271,
"username": "grock1",
"name": "grock1",
"avatar_url": "http://avatars.stocktwits.com/production/61271/thumb-1300238031.png",
"avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/production/61271/thumb-1300238031.png",
"identity": "User",
"classification": [],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "",
"website_url": "",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Momentum",
"holding_period": "Swing Trader",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"conversation": {
"parent_message_id": 10349526,
"in_reply_to_message_id": 10349526,
"parent": false,
"replies": 2
},
"entities": {
"sentiment": null
}
}
]
}
Returns the most recent 30 messages with trending symbols in the last 5 minutes.
View the display guidelines
https://api.stocktwits.com/api/2/streams/trending.json
No
No
JSON
GET
Parameters
| since: | Returns results with an ID greater than (more recent than) the specified ID. |
| max: | Returns results with an ID less than (older than) or equal to the specified ID. |
| limit: | Default and max limit is 30. This limit must be a number under 30. |
| callback: | Define your own callback function name, add this parameter as the value. |
| filter: | Filter messages by links, charts, videos, or top. (Optional) |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/streams/trending.json?access_token=<access_token>
{
"response": {
"status": 200
},
"cursor": {
"more": true,
"since": 7,
"max": 9
},
"messages": [
{
"id": 7,
"body": "short $JOY",
"created_at": "2012-10-08 21:38:56 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": [
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 17,
"symbol": "JOY",
"title": "Joy Global, Inc.",
"exchange": "NYSE",
"sector": "Industrial Goods",
"industry": "REIT - Residential",
"trending": false
}
],
"entities": {
"sentiment": null
}
},
{
"id": 8,
"body": "an idea about a $GOOG",
"created_at": "2012-10-08 21:38:56 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": [
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 15,
"symbol": "GOOG",
"title": "Google Inc.",
"exchange": "NASDAQ",
"sector": "Technology",
"industry": "Other",
"trending": false
}
],
"entities": {
"sentiment": null
}
},
{
"id": 9,
"body": "more ideas about $ARR",
"created_at": "2012-10-08 21:38:56 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": [
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 16,
"symbol": "ARR",
"title": "ARMOUR Residential REIT, Inc.",
"exchange": "NYSE",
"sector": "Financial",
"industry": "Internet Information Providers",
"trending": false
}
],
"entities": {
"sentiment": null
}
}
]
}
Returns the most recent 30 messages posted by verified Investor Relations customers.
View the display guidelines
The extended metadata in the API response below is only available through Partner-Level Access
https://api.stocktwits.com/api/2/streams/investor_relations.json
No
No
JSON
GET
Parameters
| since: | Returns results with an ID greater than (more recent than) the specified ID. |
| max: | Returns results with an ID less than (older than) or equal to the specified ID. |
| limit: | Default and max limit is 30. This limit must be a number under 30. |
| callback: | Define your own callback function name, add this parameter as the value. |
| filter: | Filter messages by links, charts, videos, or top. (Optional) |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/streams/investor_relations.json
{
"response": {
"status": 200
},
"cursor": {
"more": true,
"since": 58,
"max": 60
},
"messages": [
{
"id": 58,
"body": "more ideas about $JOY",
"created_at": "2012-10-08 21:42: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": "Official",
"classification": [
"ir",
"suggested"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 17,
"symbol": "JOY",
"title": "Joy Global, Inc.",
"exchange": "NYSE",
"sector": "Industrial Goods",
"industry": "REIT - Residential",
"trending": false
}
],
"entities": {
"sentiment": null
}
},
{
"id": 59,
"body": "something about $GOOG",
"created_at": "2012-10-08 21:42: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": "Official",
"classification": [
"ir",
"suggested"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 15,
"symbol": "GOOG",
"title": "Google Inc.",
"exchange": "NASDAQ",
"sector": "Technology",
"industry": "Other",
"trending": false
}
],
"entities": {
"sentiment": null
}
},
{
"id": 60,
"body": "I bought $ARR",
"created_at": "2012-10-08 21:42: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": "Official",
"classification": [
"ir",
"suggested"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 16,
"symbol": "ARR",
"title": "ARMOUR Residential REIT, Inc.",
"exchange": "NYSE",
"sector": "Financial",
"industry": "Internet Information Providers",
"trending": false
}
],
"entities": {
"sentiment": null
}
}
]
}
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.
View the display guidelines
The extended metadata in the API response below is only available through Partner-Level Access
https://api.stocktwits.com/api/2/streams/home.json
No
JSON
GET
Parameters
| since: | Returns results with an ID greater than (more recent than) the specified ID. |
| max: | Returns results with an ID less than (older than) or equal to the specified ID. |
| limit: | Default and max limit is 30. This limit must be a number under 30. |
| callback: | Define your own callback function name, add this parameter as the value. |
| filter: | Filter messages by links, charts, videos, or top. (Optional) |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/streams/home.json?access_token=<access_token>
{
"response": {
"status": 200
},
"cursor": {
"more": true,
"since": 19,
"max": 21
},
"messages": [
{
"id": 19,
"body": "I sold $JOY",
"created_at": "2012-10-08 21:39:31 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": [
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 17,
"symbol": "JOY",
"title": "Joy Global, Inc.",
"exchange": "NYSE",
"sector": "Industrial Goods",
"industry": "REIT - Residential",
"trending": false
}
],
"entities": {
"sentiment": null
}
},
{
"id": 20,
"body": "long $GOOG",
"created_at": "2012-10-08 21:39:31 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": [
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 15,
"symbol": "GOOG",
"title": "Google Inc.",
"exchange": "NASDAQ",
"sector": "Technology",
"industry": "Other",
"trending": false
}
],
"entities": {
"sentiment": null
}
},
{
"id": 21,
"body": "short $ARR",
"created_at": "2012-10-08 21:39:31 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": [
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 16,
"symbol": "ARR",
"title": "ARMOUR Residential REIT, Inc.",
"exchange": "NYSE",
"sector": "Financial",
"industry": "Internet Information Providers",
"trending": false
}
],
"entities": {
"sentiment": null
}
}
]
}
Returns the most recent 30 messages posted to the authenticating user's people stream of the users they follow.
View the display guidelines
The extended metadata in the API response below is only available through Partner-Level Access
https://api.stocktwits.com/api/2/streams/friends.json
No
JSON
GET
Parameters
| since: | Returns results with an ID greater than (more recent than) the specified ID. |
| max: | Returns results with an ID less than (older than) or equal to the specified ID. |
| limit: | Default and max limit is 30. This limit must be a number under 30. |
| callback: | Define your own callback function name, add this parameter as the value. |
| filter: | Filter messages by links, charts, videos, or top. (Optional) |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/streams/friends.json?access_token=<access_token>
{
"response": {
"status": 200
},
"cursor": {
"more": true,
"since": 1,
"max": 3
},
"messages": [
{
"id": 1,
"body": "an idea about a $JOY",
"created_at": "2012-10-08 21:38: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": [
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 17,
"symbol": "JOY",
"title": "Joy Global, Inc.",
"exchange": "NYSE",
"sector": "Industrial Goods",
"industry": "REIT - Residential",
"trending": false
}
],
"entities": {
"sentiment": null
}
},
{
"id": 2,
"body": "more ideas about $GOOG",
"created_at": "2012-10-08 21:38: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": [
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 15,
"symbol": "GOOG",
"title": "Google Inc.",
"exchange": "NASDAQ",
"sector": "Technology",
"industry": "Other",
"trending": false
}
],
"entities": {
"sentiment": null
}
},
{
"id": 3,
"body": "something about $ARR",
"created_at": "2012-10-08 21:38: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": [
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 16,
"symbol": "ARR",
"title": "ARMOUR Residential REIT, Inc.",
"exchange": "NYSE",
"sector": "Financial",
"industry": "Internet Information Providers",
"trending": false
}
],
"entities": {
"sentiment": null
}
}
]
}
Returns the most recent 30 messages containing mentions of the authenticating user's handle. These are considered public replies
View the display guidelines
The extended metadata in the API response below is only available through Partner-Level Access
https://api.stocktwits.com/api/2/streams/mentions.json
No
JSON
GET
Parameters
| since: | Returns results with an ID greater than (more recent than) the specified ID. |
| max: | Returns results with an ID less than (older than) or equal to the specified ID. |
| limit: | Default and max limit is 30. This limit must be a number under 30. |
| callback: | Define your own callback function name, add this parameter as the value. |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/streams/mentions.json?access_token=<access_token>
{
"response": {
"status": 200
},
"cursor": {
"more": true,
"since": 52,
"max": 54
},
"messages": [
{
"id": 52,
"body": "something about $JOY",
"created_at": "2012-10-08 21:41:56 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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 17,
"symbol": "JOY",
"title": "Joy Global, Inc.",
"exchange": "NYSE",
"sector": "Industrial Goods",
"industry": "REIT - Residential",
"trending": false
}
],
"conversation": {
"parent_message_id": 52,
"in_reply_to_message_id": null,
"parent": true,
"replies": 0
},
"entities": {
"sentiment": null
}
},
{
"id": 53,
"body": "I bought $GOOG",
"created_at": "2012-10-08 21:41:56 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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 15,
"symbol": "GOOG",
"title": "Google Inc.",
"exchange": "NASDAQ",
"sector": "Technology",
"industry": "Other",
"trending": false
}
],
"conversation": {
"parent_message_id": 53,
"in_reply_to_message_id": null,
"parent": true,
"replies": 0
},
"entities": {
"sentiment": null
}
},
{
"id": 54,
"body": "I sold $ARR",
"created_at": "2012-10-08 21:41:56 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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 16,
"symbol": "ARR",
"title": "ARMOUR Residential REIT, Inc.",
"exchange": "NYSE",
"sector": "Financial",
"industry": "Internet Information Providers",
"trending": false
}
],
"conversation": {
"parent_message_id": 54,
"in_reply_to_message_id": null,
"parent": true,
"replies": 0
},
"entities": {
"sentiment": null
}
}
]
}
Returns the most recent 30 direct messages sent to the authenticating user. These area all private messages sent and recieved.
View the display guidelines
The extended metadata in the API response below is only available through Partner-Level Access
https://api.stocktwits.com/api/2/streams/direct.json
No
JSON
GET
Parameters
| since: | Returns results with an ID greater than (more recent than) the specified ID. |
| max: | Returns results with an ID less than (older than) or equal to the specified ID. |
| limit: | Default and max limit is 30. This limit must be a number under 30. |
| callback: | Define your own callback function name, add this parameter as the value. |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/streams/direct.json?access_token=<access_token>
{
"response": {
"status": 200
},
"cursor": {
"more": true,
"since": 70,
"max": 72
},
"messages": [
{
"id": 70,
"body": "short $JOY",
"created_at": "2012-10-08 21:42:54 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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 17,
"symbol": "JOY",
"title": "Joy Global, Inc.",
"exchange": "NYSE",
"sector": "Industrial Goods",
"industry": "REIT - Residential",
"trending": false
}
],
"recipient": {
"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"
],
"followers": 0,
"following": 0,
"ideas": 3,
"following_stocks": 0,
"bio": "Product at StockTwits",
"website_url": "http://justinpaterno.com",
"trading_strategy": {
"assets_frequently_traded": [
"Equities",
"Options",
"Forex"
],
"approach": "Growth",
"holding_period": "Position Trader",
"experience": "Intermediate"
}
},
"entities": {
"sentiment": null
}
},
{
"id": 71,
"body": "an idea about a $ARR",
"created_at": "2012-10-08 21:42:54 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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 16,
"symbol": "ARR",
"title": "ARMOUR Residential REIT, Inc.",
"exchange": "NYSE",
"sector": "Financial",
"industry": "Internet Information Providers",
"trending": false
}
],
"recipient": {
"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": [
],
"followers": 0,
"following": 0,
"ideas": 6,
"following_stocks": 0,
"bio": "Founder and CEO of Stocktwits, Founder of Wallstrip (Acquired by CBS), Managing Member of Lindzon Capital Partners (Hedge Fund) and Managing Member of Social Leverage (an early stage web holding company) ...I have lot's of ideas.",
"website_url": "http://www.howardlindzon.com",
"trading_strategy": {
"assets_frequently_traded": [
"Equities",
"Options",
"Forex"
],
"approach": "Momentum",
"holding_period": "Swing Trader",
"experience": "Novice"
}
},
"entities": {
"sentiment": null
}
},
{
"id": 72,
"body": "more ideas about $ARR",
"created_at": "2012-10-08 21:42:54 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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 16,
"symbol": "ARR",
"title": "ARMOUR Residential REIT, Inc.",
"exchange": "NYSE",
"sector": "Financial",
"industry": "Internet Information Providers",
"trending": false
}
],
"recipient": {
"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"
],
"followers": 0,
"following": 0,
"ideas": 3,
"following_stocks": 0,
"bio": "Product at StockTwits",
"website_url": "http://justinpaterno.com",
"trading_strategy": {
"assets_frequently_traded": [
"Equities",
"Options",
"Forex"
],
"approach": "Growth",
"holding_period": "Position Trader",
"experience": "Intermediate"
}
},
"entities": {
"sentiment": null
}
}
]
}
Returns the most recent 30 direct messages sent from the authenticating user. These are the sent private messages.
The extended metadata in the API response below is only available through Partner-Level Access
https://api.stocktwits.com/api/2/streams/direct_sent.json
No
JSON
GET
Parameters
| since: | Returns results with an ID greater than (more recent than) the specified ID. |
| max: | Returns results with an ID less than (older than) or equal to the specified ID. |
| limit: | Default and max limit is 30. This limit must be a number under 30. |
| callback: | Define your own callback function name, add this parameter as the value. |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/streams/direct_sent.json?access_token=<access_token>
{
"response": {
"status": 200
},
"cursor": {
"more": true,
"since": 46,
"max": 48
},
"messages": [
{
"id": 46,
"body": "I bought $JOY",
"created_at": "2012-10-08 21:41:09 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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 17,
"symbol": "JOY",
"title": "Joy Global, Inc.",
"exchange": "NYSE",
"sector": "Industrial Goods",
"industry": "REIT - Residential",
"trending": false
}
],
"recipient": {
"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"
],
"followers": 0,
"following": 0,
"ideas": 3,
"following_stocks": 0,
"bio": "Product at StockTwits",
"website_url": "http://justinpaterno.com",
"trading_strategy": {
"assets_frequently_traded": [
"Equities",
"Options",
"Forex"
],
"approach": "Growth",
"holding_period": "Position Trader",
"experience": "Intermediate"
}
},
"entities": {
"sentiment": null
}
},
{
"id": 47,
"body": "I sold $ARR",
"created_at": "2012-10-08 21:41:10 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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 16,
"symbol": "ARR",
"title": "ARMOUR Residential REIT, Inc.",
"exchange": "NYSE",
"sector": "Financial",
"industry": "Internet Information Providers",
"trending": false
}
],
"recipient": {
"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": [
],
"followers": 0,
"following": 0,
"ideas": 3,
"following_stocks": 0,
"bio": "Founder and CEO of Stocktwits, Founder of Wallstrip (Acquired by CBS), Managing Member of Lindzon Capital Partners (Hedge Fund) and Managing Member of Social Leverage (an early stage web holding company) ...I have lot's of ideas.",
"website_url": "http://www.howardlindzon.com",
"trading_strategy": {
"assets_frequently_traded": [
"Equities",
"Options",
"Forex"
],
"approach": "Momentum",
"holding_period": "Swing Trader",
"experience": "Novice"
}
},
"entities": {
"sentiment": null
}
},
{
"id": 48,
"body": "long $ARR",
"created_at": "2012-10-08 21:41:10 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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 16,
"symbol": "ARR",
"title": "ARMOUR Residential REIT, Inc.",
"exchange": "NYSE",
"sector": "Financial",
"industry": "Internet Information Providers",
"trending": false
}
],
"recipient": {
"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"
],
"followers": 0,
"following": 0,
"ideas": 3,
"following_stocks": 0,
"bio": "Product at StockTwits",
"website_url": "http://justinpaterno.com",
"trading_strategy": {
"assets_frequently_traded": [
"Equities",
"Options",
"Forex"
],
"approach": "Growth",
"holding_period": "Position Trader",
"experience": "Intermediate"
}
},
"entities": {
"sentiment": null
}
}
]
}
Returns the most recent 30 direct messages received by the authenticating user. These are private messages received from people the user is following.
The extended metadata in the API response below is only available through Partner-Level Access
https://api.stocktwits.com/api/2/streams/direct_received.json
No
JSON
GET
Parameters
| since: | Returns results with an ID greater than (more recent than) the specified ID. |
| max: | Returns results with an ID less than (older than) or equal to the specified ID. |
| limit: | Default and max limit is 30. This limit must be a number under 30. |
| callback: | Define your own callback function name, add this parameter as the value. |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/streams/direct_received.json?access_token=<access_token>
{
"response": {
"status": 200
},
"cursor": {
"more": true,
"since": 28,
"max": 30
},
"messages": [
{
"id": 28,
"body": "short $JOY",
"created_at": "2012-10-08 21:39:58 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": [
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 17,
"symbol": "JOY",
"title": "Joy Global, Inc.",
"exchange": "NYSE",
"sector": "Industrial Goods",
"industry": "REIT - Residential",
"trending": false
}
],
"recipient": {
"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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Product at StockTwits",
"website_url": "http://justinpaterno.com",
"trading_strategy": {
"assets_frequently_traded": [
"Equities",
"Options",
"Forex"
],
"approach": "Growth",
"holding_period": "Position Trader",
"experience": "Intermediate"
}
},
"entities": {
"sentiment": null
}
},
{
"id": 29,
"body": "an idea about a $ARR",
"created_at": "2012-10-08 21:39:58 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": [
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 16,
"symbol": "ARR",
"title": "ARMOUR Residential REIT, Inc.",
"exchange": "NYSE",
"sector": "Financial",
"industry": "Internet Information Providers",
"trending": false
}
],
"recipient": {
"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": [
],
"followers": 0,
"following": 0,
"ideas": 3,
"following_stocks": 0,
"bio": "Founder and CEO of Stocktwits, Founder of Wallstrip (Acquired by CBS), Managing Member of Lindzon Capital Partners (Hedge Fund) and Managing Member of Social Leverage (an early stage web holding company) ...I have lot's of ideas.",
"website_url": "http://www.howardlindzon.com",
"trading_strategy": {
"assets_frequently_traded": [
"Equities",
"Options",
"Forex"
],
"approach": "Momentum",
"holding_period": "Swing Trader",
"experience": "Novice"
}
},
"entities": {
"sentiment": null
}
},
{
"id": 30,
"body": "more ideas about $ARR",
"created_at": "2012-10-08 21:39:58 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": [
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 16,
"symbol": "ARR",
"title": "ARMOUR Residential REIT, Inc.",
"exchange": "NYSE",
"sector": "Financial",
"industry": "Internet Information Providers",
"trending": false
}
],
"recipient": {
"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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Product at StockTwits",
"website_url": "http://justinpaterno.com",
"trading_strategy": {
"assets_frequently_traded": [
"Equities",
"Options",
"Forex"
],
"approach": "Growth",
"holding_period": "Position Trader",
"experience": "Intermediate"
}
},
"entities": {
"sentiment": null
}
}
]
}
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.
View the display guidelines
The extended metadata in the API response below is only available through Partner-Level Access
https://api.stocktwits.com/api/2/streams/watchlist/:id.json
No
JSON
GET
Parameters
| id: | ID of the watch list you want to show from the authenticating user (Required) |
| since: | Returns results with an ID greater than (more recent than) the specified ID. |
| max: | Returns results with an ID less than (older than) or equal to the specified ID. |
| limit: | Default and max limit is 30. This limit must be a number under 30. |
| callback: | Define your own callback function name, add this parameter as the value. |
| filter: | Filter messages by links, charts, videos, or top. (Optional) |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/streams/watchlist/<watchlist_id>.json?access_token=<access_token>
{
"response": {
"status": 200
},
"watchlist": {
"id": 12345,
"name": "my picks",
"updated_at": "2012-10-01 21:39:05 UTC",
"created_at": "2012-09-24 21:39:05 UTC"
},
"cursor": {
"more": true,
"since": 10,
"max": 12
},
"messages": [
{
"id": 10,
"body": "something about $JOY",
"created_at": "2012-10-08 21:39:05 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": [
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 17,
"symbol": "JOY",
"title": "Joy Global, Inc.",
"exchange": "NYSE",
"sector": "Industrial Goods",
"industry": "REIT - Residential",
"trending": false
}
],
"entities": {
"sentiment": null
}
},
{
"id": 11,
"body": "I bought $GOOG",
"created_at": "2012-10-08 21:39:05 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": [
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 15,
"symbol": "GOOG",
"title": "Google Inc.",
"exchange": "NASDAQ",
"sector": "Technology",
"industry": "Other",
"trending": false
}
],
"entities": {
"sentiment": null
}
},
{
"id": 12,
"body": "I sold $ARR",
"created_at": "2012-10-08 21:39:05 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": [
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 16,
"symbol": "ARR",
"title": "ARMOUR Residential REIT, Inc.",
"exchange": "NYSE",
"sector": "Financial",
"industry": "Internet Information Providers",
"trending": false
}
],
"entities": {
"sentiment": null
}
}
]
}
This allows an API application to search for a symbol or user. 30 Results will be a combined list of symbols and users.
The extended metadata in the API response below is only available through Partner-Level Access
https://api.stocktwits.com/api/2/search.json
No
No
No
JSON
GET
Parameters
| q: | The symbol or user string that you want to search for (Required) |
| callback: | Define your own callback function name, add this parameter as the value. |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/search.json?access_token=<access_token> 'q=stocktwits'
{
"response": {
"status": 200
},
"results": [
{
"id": 17,
"symbol": "JOY",
"title": "Joy Global, Inc.",
"exchange": "NYSE",
"sector": "Industrial Goods",
"industry": "REIT - Residential",
"type": "symbol"
},
{
"id": 16,
"symbol": "ARR",
"title": "ARMOUR Residential REIT, Inc.",
"exchange": "NYSE",
"sector": "Financial",
"industry": "Internet Information Providers",
"type": "symbol"
},
{
"id": 15,
"symbol": "GOOG",
"title": "Google Inc.",
"exchange": "NASDAQ",
"sector": "Technology",
"industry": "Other",
"type": "symbol"
},
{
"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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
},
"type": "user"
}
]
}
This allows an API application to search for a symbol directly. 30 Results will return only ticker symbols.
The extended metadata in the API response below is only available through Partner-Level Access
https://api.stocktwits.com/api/2/search/symbols.json
No
No
No
JSON
GET
Parameters
| q: | The symbol that you want to search for (Required) |
| callback: | Define your own callback function name, add this parameter as the value. |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/search/symbols.json?access_token=<access_token> 'q=AAPL'
{
"response": {
"status": 200
},
"results": [
{
"id": 17,
"symbol": "JOY",
"title": "Joy Global, Inc.",
"exchange": "NYSE",
"sector": "Industrial Goods",
"industry": "REIT - Residential",
"type": "symbol"
}
]
}
This allows an API application to search for a user directly. 30 Results will only return users.
The extended metadata in the API response below is only available through Partner-Level Access
https://api.stocktwits.com/api/2/search/users.json
No
No
No
JSON
GET
Parameters
| q: | The user that you want to search for (Required) |
| callback: | Define your own callback function name, add this parameter as the value. |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/search/users.json?access_token=<access_token> 'q=howardlindzon'
{
"response": {
"status": 200
},
"results": [
{
"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": [
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Founder and CEO of Stocktwits, Founder of Wallstrip (Acquired by CBS), Managing Member of Lindzon Capital Partners (Hedge Fund) and Managing Member of Social Leverage (an early stage web holding company) ...I have lot's of ideas.",
"website_url": "http://www.howardlindzon.com",
"trading_strategy": {
"assets_frequently_traded": [
"Equities",
"Options",
"Forex"
],
"approach": "Momentum",
"holding_period": "Swing Trader",
"experience": "Novice"
},
"type": "user"
}
]
}
Returns a list of all the trending symbols at the moment requested. Trending symbols include equties and non-equities like futures and forex. These are updated in 5-minute intervals.
https://api.stocktwits.com/api/2/trending/symbols.json
No
No
No
JSON
GET
Parameters
| limit: | Default and max limit is 30. This limit must be a number under 30. |
| callback: | Define your own callback function name, add this parameter as the value. |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/trending/symbols.json?access_token=<access_token>
{
"response": {
"status": 200
},
"symbols": [
{
"id": 32,
"symbol": "TF_F",
"title": "Russell 2000 Index Mini Futures",
"exchange": "ICE",
"sector": null,
"industry": null
},
{
"id": 31,
"symbol": "NQ_F",
"title": "E-Mini NASDAQ 100 Futures",
"exchange": "CME",
"sector": null,
"industry": null
},
{
"id": 30,
"symbol": "ES_F",
"title": "E-Mini S&P 500 Futures",
"exchange": "CME",
"sector": null,
"industry": null
}
]
}
Returns a list of all the trending equity symbols at the moment requested. Trending equities have to have a price over $5. These are updated in 5 minute intervals.
https://api.stocktwits.com/api/2/trending/symbols/equities.json
No
No
No
JSON
GET
Parameters
| limit: | Default and max limit is 30. This limit must be a number under 30. |
| callback: | Define your own callback function name, add this parameter as the value. |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/trending/symbols/equities.json?access_token=<access_token>
{
"response": {
"status": 200
},
"symbols": [
{
"id": 32,
"symbol": "TF_F",
"title": "Russell 2000 Index Mini Futures",
"exchange": "ICE",
"sector": null,
"industry": null
},
{
"id": 31,
"symbol": "NQ_F",
"title": "E-Mini NASDAQ 100 Futures",
"exchange": "CME",
"sector": null,
"industry": null
},
{
"id": 30,
"symbol": "ES_F",
"title": "E-Mini S&P 500 Futures",
"exchange": "CME",
"sector": null,
"industry": null
}
]
}
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.
https://api.stocktwits.com/api/2/messages/create.json
No
No
No
JSON
POST
Parameters
| body: | 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 (Required) |
| in_reply_to_message_id: | The ID this message replies to, if any. (Optional) |
| chart: | Path or URL to file to be uploaded. File Formats accepted: JPG, PNG, GIF under 1MB (Optional) |
| sentiment: | A sentiment label for the message. Acceptable values: bullish, bearish, neutral. Defaults to neutral. (Optional) |
cURL [ about cURL ] //Regular Message curl -X POST https://api.stocktwits.com/api/2/messages/create.json?access_token=<access_token> -d 'body=Creating a new message' Note that the $ character in the message may need to be escaped (\$) to prevent the shell from interpolating an environment variable. //Uploading a Chart curl https://api.stocktwits.com/api/2/messages/create.json -F access_token=<access_token> -F body="Creating a new message with a chart. \$ticker" -F chart=@/path/to/a/local/image/file.jpg //Uploading a Chart via Url curl https://api.stocktwits.com/api/2/messages/create.json -F access_token=<access_token> -F body="Creating a new message with a chart. \$ticker" -F chart="http://i.imgur.com/vMlZa.gif"
To link to a message landing page in the case of a chart or video you can create a link to the page using this path: http://stocktwits.com/message/{Message ID}
{
"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"
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 31,
"symbol": "NQ_F",
"title": "E-Mini NASDAQ 100 Futures",
"exchange": "CME",
"sector": null,
"industry": null
}
],
"entities": {
"chart": {
"thumb": "/chart_images/small/missing.png",
"original": "/chart_images/original/missing.png"
},
"sentiment": null
}
}
}
This shows the specified message details. This is used in a stand alone display.
View the display guidelines
The extended metadata in the API response below is only available through Partner-Level Access
https://api.stocktwits.com/api/2/messages/show/:id.json
No
No
No
JSON
GET
Parameters
| id: | ID of the message you want to show from the authenticating user (Required) |
| conversation: | Set to true to retrieve all meesages of the associated conversation. (Optional) |
| callback: | Define your own callback function name, add this parameter as the value. |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/messages/show/<message_id>.json?access_token=<access_token>
{
"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": [
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": [
"Equities"
],
"approach": "Growth",
"holding_period": "Long Term Investor",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 31,
"symbol": "NQ_F",
"title": "E-Mini NASDAQ 100 Futures",
"exchange": "CME",
"sector": null,
"industry": null
}
],
"entities": {
"chart": {
"thumb": "/chart_images/small/missing.png",
"original": "/chart_images/original/missing.png"
},
"sentiment": null
}
}
}
Like a message on StockTwits as the authenticating user.
https://api.stocktwits.com/api/2/messages/like.json
No
No
No
JSON
POST
Parameters
| id: | ID of the message you want to like for the authenticating user (Required) |
cURL [ about cURL ] curl -X POST https://api.stocktwits.com/api/2/messages/like.json?access_token=<access_token> -d 'id=31415926'
{
"response": {
"status": 200
},
"message": {
"id": 13,
"body": "long $NQ_F",
"created_at": "2012-10-08 21:39:15 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": [
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Founder and CEO of Stocktwits, Founder of Wallstrip (Acquired by CBS), Managing Member of Lindzon Capital Partners (Hedge Fund) and Managing Member of Social Leverage (an early stage web holding company) ...I have lot's of ideas.",
"website_url": "http://www.howardlindzon.com",
"trading_strategy": {
"assets_frequently_traded": [
"Equities",
"Options",
"Forex"
],
"approach": "Momentum",
"holding_period": "Swing Trader",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 31,
"symbol": "NQ_F",
"title": "E-Mini NASDAQ 100 Futures",
"exchange": "CME",
"sector": null,
"industry": null
}
],
"entities": {
"sentiment": null
}
}
}
Unlike a message on StockTwits as the authenticating user.
https://api.stocktwits.com/api/2/messages/unlike.json
No
No
No
JSON
POST
Parameters
| id: | ID of the message you want to unlike for the authenticating user (Required) |
cURL [ about cURL ] curl -X POST https://api.stocktwits.com/api/2/messages/unlike.json?access_token=<access_token> -d 'id=31415926'
{
"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": [
],
"followers": 0,
"following": 0,
"ideas": 0,
"following_stocks": 0,
"bio": "Founder and CEO of Stocktwits, Founder of Wallstrip (Acquired by CBS), Managing Member of Lindzon Capital Partners (Hedge Fund) and Managing Member of Social Leverage (an early stage web holding company) ...I have lot's of ideas.",
"website_url": "http://www.howardlindzon.com",
"trading_strategy": {
"assets_frequently_traded": [
"Equities",
"Options",
"Forex"
],
"approach": "Momentum",
"holding_period": "Swing Trader",
"experience": "Novice"
}
},
"source": {
"id": 1,
"title": "StockTwits",
"url": "http://stocktwits.com"
},
"symbols": [
{
"id": 31,
"symbol": "NQ_F",
"title": "E-Mini NASDAQ 100 Futures",
"exchange": "CME",
"sector": null,
"industry": null
}
],
"entities": {
"sentiment": null
}
}
}
This is to publically follow a ticker symbol and receive all messages about the symbol.
The extended metadata in the API response below is only available through Partner-Level Access
https://api.stocktwits.com/api/2/stockships/create/:id.json
No
No
No
JSON
POST
Parameters
| id: | The Stock ID of the symbol you want to follow (Required) |
cURL [ about cURL ] curl -X POST https://api.stocktwits.com/api/2/stockships/create/<symbol_id>.json?access_token=<access_token>
{
"response": {
"status": 200
},
"symbol": {
"id": 32,
"symbol": "TF_F",
"title": "Russell 2000 Index Mini Futures",
"exchange": "ICE",
"sector": null,
"industry": null
}
}
This is to unfollow a ticker symbol and no longer recieve the messages about this symbol.
The extended metadata in the API response below is only available through Partner-Level Access
https://api.stocktwits.com/api/2/stockships/destroy/:id.json
No
No
No
JSON
POST
Parameters
| id: | The Stock ID of the symbol you want to unfollow (Required) |
cURL [ about cURL ] curl -X POST https://api.stocktwits.com/api/2/stockships/destroy/<symbol_id>.json?access_token=<access_token>
{
"response": {
"status": 200
},
"symbol": {
"id": 32,
"symbol": "TF_F",
"title": "Russell 2000 Index Mini Futures",
"exchange": "ICE",
"sector": null,
"industry": null
}
}
This is to publically follow a user and create a friendship and receive all messages from this user.
The extended metadata in the API response below is only available through Partner-Level Access
https://api.stocktwits.com/api/2/friendships/create/:id.json
No
No
No
JSON
POST
Parameters
| id: | The User ID of the StockTwits user you want to follow (Required) |
cURL [ about cURL ] curl -X POST https://api.stocktwits.com/api/2/friendships/create/<user_id>.json?access_token=<access_token>
{
"response": {"status": 200},
"user": {
"id": 5,
"username": "howardlindzon",
"name": "Howard Lindzon",
"avatar_url": "http://avatars.stocktwits.net/production/5/thumb-1314510834.png",
"avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/production/5/thumb-1314510834.png",
"identity": "User",
"classification": ["suggested"],
"followers": 23220,
"following": 207,
"ideas": 25862,
"following_stocks": 32,
"bio": "Founder and CEO of Stocktwits, Founder of Wallstrip (Acquired by CBS), Managing Member of Lindzon Capital Partners (Hedge Fund) and Managing Member of Social Leverage (an early stage web holding company) ...I have lot's of ideas.",
"website_url": "http://www.howardlindzon.com",
"trading_strategy": {
"assets_frequently_traded": ["Equities"],
"approach": "Momentum",
"holding_period": "Position Trader",
"experience": "Intermediate"
}
}
}
This it to unfollow a user and end the friendship and no longer receive the users messages.
The extended metadata in the API response below is only available through Partner-Level Access
https://api.stocktwits.com/api/2/friendships/destroy/:id.json
No
No
No
JSON
POST
Parameters
| id: | The User ID of the StockTwits user you want to unfollow (Required) |
cURL [ about cURL ] curl -X POST https://api.stocktwits.com/api/2/friendships/destroy/<user_id>.json?access_token=<access_token>
{
"response": {"status": 200},
"user": {
"id": 5,
"username": "howardlindzon",
"name": "Howard Lindzon",
"avatar_url": "http://avatars.stocktwits.net/production/5/thumb-1314510834.png",
"avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/production/5/thumb-1314510834.png",
"identity": "User",
"classification": ["suggested"],
"followers": 23220,
"following": 207,
"ideas": 25862,
"following_stocks": 32,
"bio": "Founder and CEO of Stocktwits, Founder of Wallstrip (Acquired by CBS), Managing Member of Lindzon Capital Partners (Hedge Fund) and Managing Member of Social Leverage (an early stage web holding company) ...I have lot's of ideas.",
"website_url": "http://www.howardlindzon.com",
"trading_strategy": {
"assets_frequently_traded": ["Equities"],
"approach": "Momentum",
"holding_period": "Position Trader",
"experience": "Intermediate"
}
}
}
Returns the list of users the authenticated user is following.
The extended metadata in the API response below is only available through Partner-Level Access
https://api.stocktwits.com/api/2/graph/following.json
No
JSON
GET
Parameters
| since: | Returns results with an ID greater than (more recent than) the specified ID. |
| max: | Returns results with an ID less than (older than) or equal to the specified ID. |
| callback: | Define your own callback function name, add this parameter as the value. |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/graph/following.json?access_token=<access_token>
{
"response": {"status":200},
"cursor": {
"since": 1294550,
"max": 1290113,
"more": false
},
"users": [
{
"id": 51686,
"username": "christyyyjoy",
"name": "Christy Gurga",
"avatar_url": "http://avatars.stocktwits.net/production/51686/thumb-1316814491.png",
"avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/production/51686/thumb-1316814491.png",
"identity": "User",
"classification": [],
"followers": 29,
"following": 174,
"ideas": 9,
"following_stocks": 4,
"bio": "Front-end web developer at StockTwits! I spend every day making this website even better =)",
"website_url": "http://christygurga.com",
"trading_strategy": {
"assets_frequently_traded": ["Equities","Bonds"],
"approach": "Value",
"holding_period": "Long Term Investor",
"experience": null
}
},
{
"id": 37724,
"username": "ramin",
"name": "ramin",
"avatar_url": "http://avatars.stocktwits.net/production/37724/thumb-1312997378.png",
"avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/production/37724/thumb-1312997378.png",
"identity": "User",
"classification": [],
"followers": 18,
"following": 81,
"ideas": 28,
"following_stocks": 11,
"bio": "Developer at StockTwits",
"website_url": null,
"trading_strategy": {
"assets_frequently_traded": [],
"approach": null,
"holding_period": null,
"experience": null
}
},
{
"id": 27,
"username": "ppearlman",
"name": "Phil Pearlman",
"avatar_url": "http://avatars.stocktwits.net/production/27/thumb-1265901407.png",
"avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/production/27/thumb-1265901407.png",
"identity": "User",
"classification": ["suggested"],
"followers": 4470,
"following": 1193,
"ideas": 7454,
"following_stocks": 97,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": ["Options"],
"approach": "Technical",
"holding_period": "Swing Trader",
"experience": "Professional"
}
}
]
}
Returns the list of users that are following the authenticated user.
The extended metadata in the API response below is only available through Partner-Level Access
https://api.stocktwits.com/api/2/graph/followers.json
No
JSON
GET
Parameters
| since: | Returns results with an ID greater than (more recent than) the specified ID. |
| max: | Returns results with an ID less than (older than) or equal to the specified ID. |
| callback: | Define your own callback function name, add this parameter as the value. |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/graph/followers.json?access_token=<access_token>
{
"response": {"status":200},
"cursor": {
"since": 1294550,
"max": 1290113,
"more": false
},
"users": [
{
"id": 51686,
"username": "christyyyjoy",
"name": "Christy Gurga",
"avatar_url": "http://avatars.stocktwits.net/production/51686/thumb-1316814491.png",
"avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/production/51686/thumb-1316814491.png",
"identity": "User",
"classification": [],
"followers": 29,
"following": 174,
"ideas": 9,
"following_stocks": 4,
"bio": "Front-end web developer at StockTwits! I spend every day making this website even better =)",
"website_url": "http://christygurga.com",
"trading_strategy": {
"assets_frequently_traded": ["Equities","Bonds"],
"approach": "Value",
"holding_period": "Long Term Investor",
"experience": null
}
},
{
"id": 37724,
"username": "ramin",
"name": "ramin",
"avatar_url": "http://avatars.stocktwits.net/production/37724/thumb-1312997378.png",
"avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/production/37724/thumb-1312997378.png",
"identity": "User",
"classification": [],
"followers": 18,
"following": 81,
"ideas": 28,
"following_stocks": 11,
"bio": "Developer at StockTwits",
"website_url": null,
"trading_strategy": {
"assets_frequently_traded": [],
"approach": null,
"holding_period": null,
"experience": null
}
},
{
"id": 27,
"username": "ppearlman",
"name": "Phil Pearlman",
"avatar_url": "http://avatars.stocktwits.net/production/27/thumb-1265901407.png",
"avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/production/27/thumb-1265901407.png",
"identity": "User",
"classification": ["suggested"],
"followers": 4470,
"following": 1193,
"ideas": 7454,
"following_stocks": 97,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": ["Options"],
"approach": "Technical",
"holding_period": "Swing Trader",
"experience": "Professional"
}
}
]
}
Returns the list of users that were blocked by the authenticating user.
The extended metadata in the API response below is only available through Partner-Level Access
https://api.stocktwits.com/api/2/graph/blocking.json
No
JSON
GET
Parameters
| since: | Returns results with an ID greater than (more recent than) the specified ID. |
| max: | Returns results with an ID less than (older than) or equal to the specified ID. |
| callback: | Define your own callback function name, add this parameter as the value. |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/graph/blocking.json?access_token=<access_token>
{
"response": {"status":200},
"cursor": {
"since": 1294550,
"max": 1290113,
"more": false
},
"users": [
{
"id": 51686,
"username": "christyyyjoy",
"name": "Christy Gurga",
"avatar_url": "http://avatars.stocktwits.net/production/51686/thumb-1316814491.png",
"avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/production/51686/thumb-1316814491.png",
"identity": "User",
"classification": [],
"followers": 29,
"following": 174,
"ideas": 9,
"following_stocks": 4,
"bio": "Front-end web developer at StockTwits! I spend every day making this website even better =)",
"website_url": "http://christygurga.com",
"trading_strategy": {
"assets_frequently_traded": ["Equities","Bonds"],
"approach": "Value",
"holding_period": "Long Term Investor",
"experience": null
}
},
{
"id": 27,
"username": "ppearlman",
"name": "Phil Pearlman",
"avatar_url": "http://avatars.stocktwits.net/production/27/thumb-1265901407.png",
"avatar_url_ssl": "https://s3.amazonaws.com/st-avatars/production/27/thumb-1265901407.png",
"identity": "User",
"classification": ["suggested"],
"followers": 4470,
"following": 1193,
"ideas": 7454,
"following_stocks": 97,
"bio": "Psychologist, Hedgie, entrepeneur, seed investor, stocktwits ftw!",
"website_url": "http://philpearlman.com/",
"trading_strategy": {
"assets_frequently_traded": ["Options"],
"approach": "Technical",
"holding_period": "Swing Trader",
"experience": "Professional"
}
}
]
}
Returns the list of ticker symbols publically followed by the authenticating user.
The extended metadata in the API response below is only available through Partner-Level Access
https://api.stocktwits.com/api/2/graph/symbols.json
No
JSON
GET
Parameters
| since: | Returns results with an ID greater than (more recent than) the specified ID. |
| max: | Returns results with an ID less than (older than) or equal to the specified ID. |
| callback: | Define your own callback function name, add this parameter as the value. |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/graph/symbols.json?access_token=<access_token>
{
"response": {"status": 200},
"cursor": {
"since": 453526,
"max": 453524,
"more": false
},
"symbols": [
{
"id": 8404,
"symbol": "GRPN",
"title": "Groupon",
"exchange": "NASDAQ",
"sector": "Technology",
"industry": "Internet Information Providers"
},
{
"id": 1666,
"symbol": "EBAY",
"title": "eBay Inc.",
"exchange": "NASDAQ",
"sector": "Services",
"industry": "Catalog & Mail Order Houses"
},
{
"id": 9581,
"symbol": "QQQ",
"title": "PowerShares QQQ",
"exchange": "NASDAQ",
"sector": "Financial",
"industry": "Exchange Traded Fund"
}
]
}
Returns a list of private watch lists for the authenticating user.
https://api.stocktwits.com/api/2/watchlists.json
No
No
JSON
GET
Parameters
| callback: | Define your own callback function name, add this parameter as the value. |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/watchlists.json?access_token=<access_token>
{
"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"
}
]
}
This creates a private watch list for the authenticating user. A watch list will consist of many ticker symbols.
https://api.stocktwits.com/api/2/watchlists/create.json
No
No
No
JSON
POST
Parameters
| name: | The name of the new watch list. (Required) |
cURL [ about cURL ] curl -X POST https://api.stocktwits.com/api/2/watchlists/create.json?access_token=<access_token> -d 'name=new_watch_list'
{
"response": {"status":200},
"watchlist": {
"id": 38509,
"name": "new_watch_list",
"updated_at": "2012-08-13T22:09:25Z",
"created_at": "2012-08-13T22:09:25Z"
}
}
This update the contents of the specified watch list. Required parameters are the ID of the watch list that is to be updated and the new name of the watch list.
https://api.stocktwits.com/api/2/watchlists/update/:id.json
No
No
No
JSON
POST
Parameters
| id: | The ID of the watch list to be updated (Required) |
| name: | The name the watch list will be updated to. (Required) |
cURL [ about cURL ] curl -X POST https://api.stocktwits.com/api/2/watchlists/update/<watchlist_id>json?access_token=<access_token> -d 'name=new_watchlist_name'
{
"response": {"status": 200},
"watchlist": {
"id": 38509,
"name": "new_watchlist_name",
"updated_at": "2012-08-13T22:13:53Z",
"created_at": "2012-08-13T22:09:25Z"
}
}
This deletes the specified watch list. Required parameter is the ID of the watch list to be deleted, this is not the name of the watch list.
https://api.stocktwits.com/api/2/watchlists/destroy/:id.json
No
No
No
JSON
POST
Parameters
| id: | The ID of the watch list to be deleted (Required) |
cURL [ about cURL ] curl -X POST https://api.stocktwits.com/api/2/watchlists/destroy/<watchlist_id>.json?access_token=<access_token>
{
"response": {"status": 200},
"watchlist": {
"id": 38509,
"name": "new_watchlist_name",
"updated_at": "2012-08-13T22:13:53Z",
"created_at": "2012-08-13T22:09:25Z"
}
}
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.
The extended metadata in the API response below is only available through Partner-Level Access
https://api.stocktwits.com/api/2/watchlists/show/:id.json
No
No
JSON
GET
Parameters
| id: | The ID of the watch list to be shown (Required) |
| callback: | Define your own callback function name, add this parameter as the value. |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/watchlists/show/<watchlist_id>.json?access_token=<access_token>
{
"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",
"exchange": "NASDAQ",
"sector": "Technology",
"industry": "Internet Information Providers"
},
{
"id": 2044,
"symbol": "GOOG",
"title": "Google Inc.",
"exchange": "NASDAQ",
"sector": "Technology",
"industry": "Internet Information Providers"
},
{
"id": 686,
"symbol": "AAPL",
"title": "Apple Inc.",
"exchange": "NASDAQ",
"sector": "Technology",
"industry": "Personal Computers"
}
]
}
}
This adds a ticker symbol or symbols to a specified watch list. Required parameters are the ID of the watch list and the symbol or symbols to be added.
The extended metadata in the API response below is only available through Partner-Level Access
https://api.stocktwits.com/api/2/watchlists/:id/symbols/create.json
No
No
No
JSON
POST
Parameters
| id: | The ID of the watch list to add to. (Required) |
| symbols: | The ticker symbol or comma separated symbols that are to be added to the specified watch list. (Required) |
cURL [ about cURL ] curl -X POST https://api.stocktwits.com/api/2/watchlists/<watchlist_id>/symbols/create.json?access_token=<access_token> -d 'symbols=AAPL'
{
"response": {"status": 200},
"symbols": [
{
"id": 686,
"symbol": "AAPL",
"title": "Apple Inc.",
"exchange": "NASDAQ",
"sector": "Technology",
"industry": "Personal Computers"
}
]
}
Remove a symbol from the specified watch list. You must pass the ID of the watch list to which you want to add the symbol, not the name of the watch list.
The extended metadata in the API response below is only available through Partner-Level Access
https://api.stocktwits.com/api/2/watchlists/:id/symbols/destroy.json
No
No
No
JSON
POST
Parameters
| id: | The ID of the watch list that you want to add to. (Required) |
| symbols: | The ticker of the symbol that you want to remove from the specified watch list. (Required) |
cURL [ about cURL ] curl -X POST https://api.stocktwits.com/api/2/watchlists/<watchlist_id>/symbols/destroy.json?access_token=<access_token> -d 'symbols=AAPL'
{
"response": {"status": 200},
"symbols": [
{
"id": 686,
"symbol": "AAPL",
"title": "Apple Inc.",
"exchange": "NASDAQ",
"sector": "Technology",
"industry": "Personal Computers"
}
]
}
This verifies the credentials of a user. Useful for checking if authentication method is correct.
The extended metadata in the API response below is only available through Partner-Level Access
https://api.stocktwits.com/api/2/account/verify.json
No
No
JSON
GET
Parameters
| callback: | Define your own callback function name, add this parameter as the value. |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/account/verify.json?access_token=<access_token>
{
"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": [],
"followers": 0,
"following": 1,
"ideas": 0,
"following_stocks": 0,
"bio": null,
"website_url": null,
"trading_strategy": {
"assets_frequently_traded":[],
"approach": null,
"holding_period": null,
"experience": null
}
}
}
This updates the properties of the authenticating user's account.
This API end-point is only available through Partner-Level Access
https://api.stocktwits.com/api/2/account/update.json
No
No
JSON
POST
Parameters
| name: | The full name of the account holder |
| email: | The email address for the account holder |
| username: | The username for the account holder |
cURL [ about cURL ] curl -X POST https://api.stocktwits.com/api/2/account/update.json?access_token=<access_token> -d 'name=New Name'
{
"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
}
}
}
Returns a list of user accounts deleted recently. This is to be used in conjunction with firehose access.
This API end-point is only available through Partner-Level Access
https://api.stocktwits.com/api/2/deletions/users.json
JSON
GET
Parameters
| since: | Returns results with an ID greater than (more recent than) the specified ID. |
| max: | Returns results with an ID less than (older than) or equal to the specified ID. |
| callback: | Define your own callback function name, add this parameter as the value. |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/deletions/users.json?access_token=<access_token>
{
"response": {"status": 200},
"cursor": {
"since": 924,
"max": 825,
"more": true
},
"users": [
{
"id": 924,
"user_id": 147524,
"username": "SSX999",
"deleted_at": "2012-08-13T18:22:53Z"
},
{
"id": 923,
"user_id": 176669,
"username": "jhardiejr2",
"deleted_at": "2012-08-13T14:24:59Z"
},
{
"id": 922,
"user_id": 130685,
"username": "dp06x",
"deleted_at": "2012-08-13T14:18:15Z"
},
{
"id": 921,
"user_id": 158870,
"username": "daniaconcha",
"deleted_at": "2012-08-13T14:08:41Z"
},
{
"id": 920,
"user_id": 102850,
"username": "sshin1212",
"deleted_at": "2012-08-13T14:07:21Z"
},
{
"id": 919,
"user_id": 59050,
"username": "FXTrader",
"deleted_at": "2012-08-13T13:49:00Z"
}
]
}
Returns a list of messages deleted recently. This is to be used in conjuntion with firehose access.
This API end-point is only available through Partner-Level Access
https://api.stocktwits.com/api/2/deletions/messages.json
JSON
GET
Parameters
| since: | Returns results with an ID greater than (more recent than) the specified ID. |
| max: | Returns results with an ID less than (older than) or equal to the specified ID. |
| callback: | Define your own callback function name, add this parameter as the value. |
cURL [ about cURL ] curl -X GET https://api.stocktwits.com/api/2/deletions/messages.json?access_token=<access_token>
{
"response": {"status": 200},
"cursor": {
"since": 111868,
"max": 111769,
"more": true
},
"messages": [
{
"id": 111868,
"message_id": 9092561,
"deleted_at": "2012-08-13T22:29:04Z"
},
{
"id": 111867,
"message_id": 9093785,
"deleted_at": "2012-08-13T22:28:28Z"
},
{
"id": 111866,
"message_id": 9093714,
"deleted_at": "2012-08-13T22:16:05Z"
},
{
"id": 111865,
"message_id": 9093260,
"deleted_at": "2012-08-13T22:03:41Z"
},
{
"id": 111864,
"message_id": 9093113,
"deleted_at": "2012-08-13T22:03:37Z"
},
{
"id": 111863,
"message_id": 9093142,
"deleted_at": "2012-08-13T21:28:55Z"
},
]
}
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.
The extended metadata in the API response below is only available through Partner-Level Access
https://api.stocktwits.com/api/2/blocks/create/:id.json
No
No
No
JSON
POST
Parameters
| id: | The ID of the user you want to block (Required) |
cURL [ about cURL ] curl -X POST https://api.stocktwits.com/api/2/blocks/create/<user_id>.json?access_token=<access_token>
{
"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": [],
"followers": 0,
"following": 1,
"ideas": 0,
"following_stocks": 0,
"bio": null,
"website_url": null,
"trading_strategy": {
"assets_frequently_traded": [],
"approach": null,
"holding_period": null,
"experience": null
}
}
}
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.
The extended metadata in the API response below is only available through Partner-Level Access
https://api.stocktwits.com/api/2/blocks/destroy/:id.json
No
No
No
JSON
POST
Parameters
| id: | The ID of the user you want to unblock (Required) |
cURL [ about cURL ] curl -X POST https://api.stocktwits.com/api/2/blocks/destroy/<user_id>.json?access_token=<access_token>
{
"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": [],
"followers": 0,
"following": 1,
"ideas": 0,
"following_stocks": 0,
"bio": null,
"website_url": null,
"trading_strategy": {
"assets_frequently_traded": [],
"approach": null,
"holding_period": null,
"experience": null
}
}
}
