Table of contents

Authentication

To access the Acuris Research Ideas API, you need a valid username and password. If you don’t have a username or password, then you can obtain them by requesting a trial or contacting our sales team.

Use the username and password to request your API key token:

curl -XPOST -d 'username=YOUR_USERNAME' -d 'password=YOUR_PASSWORD' https://ideasequities.timgroup.com/api/v1/auth

This is an example of the response containing an Acuris Research Ideas API Key token:

{"token":"ezJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI3YzRlMzQ1Ni1mMjIyLTQ4YjgtYTc1YS04OWFhM2FjYzVhMmQiLCJuYW1lIjoiYXBhcmtlcjTiLCJpYXQiOjE1OTgyNjUyMTksInNlc3Npb24iOiI1YWRkMmN3YS00ZThmLTRhMmMtODAwYi1hZDliZDRlNTk1MTciLCJleHAiOjE1OTgyOTQwMTl9.mXfvfmQaMAOGBlRARwOADXp1YMTM4tVuFuOIUj7mEMd="}

The API key must be passed in the request as Bearer token:

curl -H 'Authorization: Bearer YOUR_API_KEY' https://ideasequities.timgroup.com/api/v1/stream/smartkarma_tradeable/-1/10

Authorization

If your API subscription is valid and there are no errors in your query, then you’ll receive a ‘200 OK’ response back with the matching payload.

If your username, password or API key is not authorized for the API you are calling, then you will receive a ‘403 Forbidden’ error.