Institution Rating

Get analyst institution rating snapshot (rating distribution and average target price).

SDK Links

Python	longport.openapi.FundamentalContext.institution_rating
Rust	longport::fundamental::FundamentalContext#institution_rating
Go	FundamentalContext.InstitutionRating
Node.js	FundamentalContext#institutionRating

Parameters

SDK method parameters.

Name	Type	Required	Description
symbol	string	YES	Security symbol, e.g. TSLA.US

Request Example

from longport.openapi import FundamentalContext, Config, OAuthBuilder

oauth = OAuthBuilder("your-client-id").build(lambda url: print("Visit:", url))
config = Config.from_oauth(oauth)
ctx = FundamentalContext(config)

resp = ctx.institution_rating("TSLA.US")
print(resp)

import asyncio
from longport.openapi import AsyncFundamentalContext, Config, OAuthBuilder

async def main() -> None:
    oauth = await OAuthBuilder("your-client-id").build_async(lambda url: print("Visit:", url))
    config = Config.from_oauth(oauth)
    ctx = AsyncFundamentalContext.create(config)

    resp = await ctx.institution_rating("TSLA.US")
    print(resp)

if __name__ == "__main__":
    asyncio.run(main())

const { Config, FundamentalContext, OAuth } = require('longport')

async function main() {
  const oauth = await OAuth.build('your-client-id', (_, url) => {
    console.log('Open this URL to authorize: ' + url)
  })
  const config = Config.fromOAuth(oauth)
  const ctx = FundamentalContext.new(config)
  const resp = await ctx.institutionRating('TSLA.US')
  console.log(resp)
}
main().catch(console.error)

import com.longport.*;
import com.longport.fundamental.*;

class Main {
    public static void main(String[] args) throws Exception {
        try (OAuth oauth = new OAuthBuilder("your-client-id").build(url -> System.out.println("Open to authorize: " + url)).get();
             Config config = Config.fromOAuth(oauth);
             FundamentalContext ctx = FundamentalContext.create(config)) {
            var resp = ctx.getInstitutionRating("TSLA.US").get();
            System.out.println(resp);
        }
    }
}

use std::sync::Arc;
use longport::{oauth::OAuthBuilder, fundamental::FundamentalContext, Config};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let oauth = OAuthBuilder::new("your-client-id").build(|url| println!("Open: {url}")).await?;
    let config = Arc::new(Config::from_oauth(oauth));
    let ctx = FundamentalContext::new(config);
    let resp = ctx.institution_rating("TSLA.US").await?;
    println!("{:?}", resp);
    Ok(())
}

#include <iostream>
#include <longport.hpp>

using namespace longport;
using namespace longport::fundamental;

int main() {
    OAuthBuilder("your-client-id").build(
        [](const std::string& url) { std::cout << "Open: " << url << std::endl; },
        [](auto res) {
            if (!res) return;
            Config config = Config::from_oauth(*res);
            FundamentalContext ctx = FundamentalContext::create(config);
            ctx.institution_rating("TSLA.US", [](auto resp) {
                if (resp) std::cout << "OK" << std::endl;
            });
        });
    std::cin.get();
}

package main

import (
	"context"
	"fmt"
	"log"

	"github.com/longportapp/openapi-go/config"
	"github.com/longportapp/openapi-go/oauth"
	"github.com/longportapp/openapi-go/fundamental"
)

func main() {
	o := oauth.New("your-client-id").
		OnOpenURL(func(url string) { fmt.Println("Open this URL to authorize:", url) })
	if err := o.Build(context.Background()); err != nil {
		log.Fatal(err)
	}
	conf, err := config.New(config.WithOAuthClient(o))
	if err != nil {
		log.Fatal(err)
	}
	c, err := fundamental.NewFromCfg(conf)
	if err != nil {
		log.Fatal(err)
	}
	defer c.Close()
	resp, err := c.InstitutionRating(context.Background(), "TSLA.US")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", resp)
}

Response

Response Example

{
  "code": 0,
  "message": "success",
  "data": {
    "latest": {
      "evaluate": {
        "buy": 18,
        "hold": 17,
        "sell": 4,
        "no_opinion": 4,
        "over": 5,
        "under": 3,
        "total": 51,
        "start_date": "1778198400",
        "end_date": "0"
      },
      "industry_id": 87676,
      "industry_mean": 10,
      "industry_median": 4,
      "industry_name": "Automobiles",
      "industry_rank": 1,
      "industry_total": 30,
      "target": {
        "highest_price": "600.000",
        "lowest_price": "123.000",
        "prev_close": "428.35",
        "start_date": "1778198400",
        "end_date": "0"
      }
    },
    "summary": {
      "ccy_symbol": "$",
      "change": "0",
      "recommend": "Buy",
      "updated_at": "1778198400",
      "evaluate": {
        "buy": 18,
        "hold": 17,
        "sell": 4
      },
      "target": {
        "average_target": "350.00",
        "highest_price": "600.000",
        "lowest_price": "123.000"
      }
    }
  }
}

Response Status

Status	Description	Schema
200	Success	InstitutionRatingResponse
400	Bad request	None

Schemas

InstitutionRatingResponse

Name	Type	Required	Description
latest	object	true	Latest analyst rating snapshot
latest.evaluate	object	true	Rating distribution
latest.evaluate.buy	integer	false	Buy ratings count
latest.evaluate.hold	integer	false	Hold ratings count
latest.evaluate.sell	integer	false	Sell ratings count
latest.evaluate.over	integer	false	Outperform count
latest.evaluate.under	integer	false	Underperform count
latest.evaluate.no_opinion	integer	false	No opinion count
latest.evaluate.total	integer	false	Total analyst count
latest.evaluate.start_date	string	false	Period start date
latest.evaluate.end_date	string	false	Period end date
latest.industry_id	integer	false	Industry ID
latest.industry_name	string	false	Industry name
latest.industry_rank	integer	false	Rank within industry
latest.industry_total	integer	false	Total stocks in industry
latest.industry_mean	integer	false	Industry mean rating
latest.industry_median	integer	false	Industry median rating
latest.target	object	false	Price target range
latest.target.highest_price	string	false	Highest target price
latest.target.lowest_price	string	false	Lowest target price
latest.target.prev_close	string	false	Previous close price
latest.target.start_date	string	false	Period start date
latest.target.end_date	string	false	Period end date
summary	object	false	Consensus rating snapshot
summary.recommend	object	false	Recommendation distribution mapping
summary.change	string	false	Price change value
summary.ccy_symbol	string	false	Currency symbol
summary.evaluate	object	false	Rating distribution counts
summary.evaluate.buy	integer	false	Buy count
summary.evaluate.strong_buy	integer	false	Strong buy count
summary.evaluate.hold	integer	false	Hold count
summary.evaluate.sell	integer	false	Sell count
summary.evaluate.under	integer	false	Underperform count
summary.target	string	false	Consensus average target price
summary.updated_at	string	false	Last update date string