💡Ideas

The ideas API retrieves ideas from users on Utradea. Ideas can be searched by ticker, start, end date, & popularity.

All GET methods associated with retrieving Utradea's user-generated ideas/positions.

// GET IDEAS
https://cloud.utradea.com/v1/get-ideas

You must pass the required headers with your enterprise access token.

Expand the below GET method table for details.

Endpoints

/get-ideas

GET URL: https://cloud.utradea.com/v1/get-ideas

Request ideas by ticker, start and end date.

Query Parameters

Name	Type	Description
tickers*	String	The company OR crypto symbol, as it is defined in Utradea. To pass multiple symbols, use a comma to seperate tickers.
startDate	Integer	Integer representation of a date-time object.
extend	String	Pass 'true' or 'false' to return the condensed or detailed version of the ideas object.
endDate	Integer	Integer representation of a date-time object.

Headers

Name	Type	Description
Content-Type*	String	application/json
Authorization*	String	${YOUR_APIKEY}

200: OK Successful requests will return the following response.

{
    statusCode 200,
    "output": [
      {
        "premium": false,
        "catalysts": [
            "news",
            "secFiling",
            "otherCatalyst"
        ],
        "username": "joeytribbiani",
        "ticker": "TSLA",
        "entryPrice": 1184.69,
        "slug": "Random-idea_0",
        "positionStatus": "new-submission",
        "positionTitle": "Random idea",
        "targetPrice": 1303.16,
        "sentiment": "bullish",
        "confidence": 1,
        "durationIndex": "< 1 Week",
        "analysisType": "general",
        "contentText": "Testing Testing Testing\n\n\n\n\nTesting Testing Testing\n\n\n\n\nTesting Testing Testing\n\n\n\n\n\n\n\nTesting Testing Testing",
        "createdAt": "2021-11-08T19:19:10.805Z",
        "commentsCount": 0,
        "upvotedownvoteCount": 0,
        "upvotes": 0,
        "downvotes": 0
        }
    ]
}

400: Bad Request The following error message is triggered if you do not pass the proper query parameters.

401: Unauthorized The following error message is triggered if you do not have the proper authentication.

500: Internal Server Error The following error message is triggered if there is an issue with Utradea's server.

429: Too Many Requests The following error message is triggered when the number of requests exceed the rate limit specified for your membership tier.

Node.js

const axios = require("axios")

const getIdeas = async () => new Promise((resolve, reject) => {
    var options = {
        method: 'GET',
        url: 'https://cloud.utradea.com/v1/get-ideas?ticker=PLTR,GOOGL,FB&?start=20211102?end=20211103',
        headers: {'
            'Content-Type': 'application/json',
            'Authorization': ${YOUR_APIKEY}
        }
    }
    axios.request(options)
        .then(function (response) {
            resolve(response.data);
        }).catch(function (error) {
            console.log('Error on Fetch: ' + error.message);
            reject(error);
        });
});

Sample JSON Response