Whispertrades offers a REST API for you to read and maintain your Whispertrades account and bots outside of the Whispertrades website itself.

The API will allow you to do such things as pull bot performance history into your own application and also start, stop, and modify bots using your own, external criteria that may not be available inside of the Whispertrades platform.

Before you can access the API, you must read and agree to the API terms and acknowledge that you have done so within your account. To do this, please refer to the "API" section in your account settings.

After you agree to the API terms, you will be taken to a page where you can manage API tokens that will be used to authenticate your application(s) that use the API.

To authenticate with the API, you will need to include a Bearer Token with all of your API requests. You can create and manage your API tokens from your Whispertrades API page.

To create a new token, visit your API page and click "Create Token" at the top. You will be prompted for a token name and also permissions for the token.

After you create the token, it will display on screen. You must copy and save that token for your own use. An existing token cannot be retrieved again after you have left the generation screen.

You can change the name, permissions, or expiration date on any existing token by clicking the edit icon next to the token.

You can revoke a token at any time by clicking on the delete icon next to the token. A deleted token will immediately lose access to the API.

For API calls to succeed, you must include a token (created above) in the Authorization header with each API request. This is commonly referred to as a Bearer Token.

A valid token has access to all resources in your Whispertrades account with the permissions that you grant the token.

All new tokens expire in 1 year. You can view each token's expiration date in your token list.

Before expiration, you will need to either extend your current token's expiration or create a new token and replace it in your application. We will send emails before expiration to remind you to generate a new token.

Do not rely on expiration for unused tokens. You should delete/revoke tokens that you no longer intend to use.

All API requests are limited to 30 per minute. This is on a Whispertrades account basis, not a token basis.

To maintain a consistent experience across the API, you can expect the following response for each API request: