Fundamental

Institutional Rating Views Timeline

GEThttps://openapi.longbridge.com/v1/quote/ratings/institutional

Authorization

Signed mode: every request is signed with your App Key/Secret. Header set:

NameTypeRequiredDescription
Authorizationstring · headerRequiredThe account Access Token from the OpenAPI dashboard — passed as the raw token (no Bearer prefix) and included in the signature calculation.
X-Api-Keystring · headerRequiredYour App Key.
X-Timestampstring · headerRequiredRequest timestamp in seconds (Unix epoch).
X-Api-Signaturestring · headerRequiredHMAC-SHA256 signature. Format: HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=.

Get the monthly institutional rating (buy/hold/sell) distribution timeline, newest first.

>_ CLI
longbridge institution-rating AAPL.US --views
longbridge institution-rating TSLA.US --views

Request

Query parameters

NameTypeRequiredDescription
symbolstringRequiredSecurity symbol, e.g. `AAPL.US`

Response

Response properties

NameTypeRequiredDescription
elistobject[]OptionalMonthly rating distribution list, newest first
└ buystringOptionalNumber of Buy ratings
└ overstringOptionalNumber of Outperform ratings
└ holdstringOptionalNumber of Hold ratings
└ understringOptionalNumber of Underperform ratings
└ sellstringOptionalNumber of Sell ratings
└ totalstringOptionalTotal analyst count
└ no_opinionstringOptionalNumber of analysts with no opinion.
└ datestringOptionalUnix timestamp (seconds)
tlistobject[]OptionalTime-series list.
└ datestringOptionalUnix timestamp (seconds)
└ closestringOptionalClosing price.
└ high_pricestringOptionalHigh price.
└ low_pricestringOptionalLow price.

Response JSON example

{
  "code": 0,
  "message": "success",
  "data": {
    "elist": [
      {
        "date": 1746057600,
        "buy": "18",
        "over": "5",
        "hold": "17",
        "under": "3",
        "sell": "4",
        "total": "51"
      },
      {
        "date": 1743379200,
        "buy": "17",
        "over": "6",
        "hold": "18",
        "under": "3",
        "sell": "5",
        "total": "53"
      }
    ]
  }
}

Error code

See the Error Codes page for the full list of error codes.