Docs/リファレンス/ランキング/ランキングの取得
GET/v1/rankings/{metric}プラン · Developer

ランキングの取得

財務指標で企業をランキングします。

選択した指標の上位N社を、指標値と基本的な企業情報とともに返します。

パスパラメータ · 1

URLパスに展開される変数。

metricstring必須

財務指標。ランキング: revenue, net_income, operating_income, ordinary_income, total_assets, total_equity, total_liabilities, gross_profit, current_assets, current_liabilities, eps, bps, roe, roa, operating_margin, net_margin, gross_margin, equity_ratio, debt_to_equity, current_ratio, interest_coverage, health_score。時系列: revenue, net_income, operating_income, ordinary_income, total_assets, total_equity, eps, bps, dividends_per_share, operating_cf, investing_cf, financing_cf, roe, pe_ratio, num_employees, cost_of_sales, gross_profit, sga, depreciation, rnd_expenses, current_assets, noncurrent_assets, ppe, intangible_assets, inventories, current_liabilities, noncurrent_liabilities, retained_earnings, capex, treasury_stock, goodwill, interest_expense, investment_securities

クエリパラメータ · 5

任意のフィルターと修飾子。URLエンコードした ?key=value で渡します。

sectorstring | null任意

セクターでフィルター

fiscal_yearinteger | null任意

決算年度でフィルター

orderstring任意

ソート順(desc=降順、asc=昇順)

default desc
limitinteger任意

1ページあたりの件数

default 50
offsetinteger任意

スキップする件数(cursor指定時は無視)

default 0

リクエストヘッダー · 1

認証ヘッダー。

Authorizationstring必須

本番用のAPIキー。次の形式で渡します: Bearer ax_live_…

返り値 · 200

標準の { data, meta } エンベロープ。 data は RankingResultOut 型の配列です。

エンベロープ

dataRankingResultOut[]

結果オブジェクトの配列。

metaMeta

ページネーションとリクエストメタデータ。request_iddata_as_ofontology_version を含みます。

ontology_version 2.1.0replay meta.as_of · ?as_of=<token>

RankingResultOut

rankinteger

ランキング順位(1始まり)。

companyCompanyOut

企業情報。

fiscal_yearinteger

ランキング対象の決算年度。

valuenumber | integer | null

ランキングに使用した指標値。

metricstring

使用した指標(例: 'revenue'、'roe')。

エラー

標準のHTTPステータスコードに加え、{ error: { code, message } } エンベロープ内で型付きの error.code を返します。

すべてのエンドポイントは共通の型付きエラーエンベロープ({ error: { code, message } })を返します。 全コードの一覧はエラーリファレンスを参照してください。