Parameters and Pagination


Some API methods take optional or required parameters. When making requests with parameters values should be converted to UTF-8 and URL encoded.

There is one special parameter in the Stocktwits API:

Where noted, some API methods will return different results based on HTTP headers sent by the client. Where the same behavior can be controlled by both a parameter and an HTTP header, the parameter will take precedence.


Clients may access a theoretical maximum of 800 messages via the cursor parameters for the API methods. Requests for more than the limit will result in a reply with a status code of 200 and an empty result in the format requested. Stocktwits still maintains a database of all the messages sent by a user. However, to ensure performance of the site, this artificial limit is temporarily in place.

There are two main parameters when paginating through results.