Get started

Company rankings (SEC) in Duaer

In Duaer: SEC EDGAR XBRL: US-listed companies ranked by revenue, net income, assets, or cash for one calendar year. One successful search uses 1 credit.

What you get

Duaer Company rankings (SEC) ranks every company that reported a metric to SEC EDGAR for a calendar year, largest first. Balance sheet metrics use the year-end value.

Pick Duaer Data → Company rankings (SEC) in the node creator, or open the data market. Related: Company financials (SEC), World Bank indicators.

When to use it

List the largest US companies by 2024 revenue.
Rank banks by total assets.

When not to use it

Several years of one company. Use Company financials (SEC).
Country economic data. Use World Bank indicators.

Search on the canvas

Open the node creator and pick Duaer Data → Company rankings (SEC).
Fill Metric (such as revenue). Optional: Year (such as 2024), Company Words (such as bank).
Limit defaults to 10, max 20. Execute.

A search uses 1 credit only when it returns rows. No rows, wrong input, or an upstream failure uses 0.

Call the API

GET https://api.duaer.com/v1/data/sec-frames?metric=revenue&year=2024
Authorization: Bearer <Duaer key>

The call skill below matches Copy skill in the Duaer data market, with parameters, examples, and result fields.

Call skill

Same text as Copy skill.

---
name: duaer-sec-frames
description: >-
  Duaer Company rankings (SEC). SEC EDGAR XBRL: US-listed companies ranked by revenue, net income, assets, or cash for one calendar year.
  One successful search uses 1 Duaer credit.
---

# Duaer Company rankings (SEC)

Duaer Company rankings (SEC) ranks every company that reported a metric to SEC EDGAR for a calendar year, largest first. Balance sheet metrics use the year-end value.

## When to use

- List the largest US companies by 2024 revenue.
- Rank banks by total assets.

## When not to use

- Several years of one company. Use https://skills.duaer.com/company-financials.md.
- Country economic data. Use https://skills.duaer.com/world-bank.md.

## Call

`GET https://api.duaer.com/v1/data/sec-frames?metric=revenue&year=2024`

Header: `Authorization: Bearer <Duaer key>`

Use an account key or a model API key.

Get a Duaer key: https://skills.duaer.com/keys.md

## Parameters

Provide `metric` or `year`.

- `metric` — `revenue`, `netIncome`, `operatingIncome`, `eps`, `assets`, `liabilities`, `equity`, or `cash`. Default revenue.
- `year` — Optional. Calendar year from 2009. Default is last year.
- `words` — Optional. Words in the company name, such as bank.
- `limit` — Optional. Rows to return, from 1 to 20. Default 10.

## Examples

- `GET https://api.duaer.com/v1/data/sec-frames?metric=revenue&year=2024` — the top companies by 2024 revenue.
- `GET https://api.duaer.com/v1/data/sec-frames?metric=assets&words=bank` — banks ranked by total assets.

## Result

The response is `{ "items": [...] }`. Each item has `source`, `title`, `url`, and `summary`, plus:

- `rank`, `company`, `cik` — position and company.
- `metric`, `value`, `unit` — figure and unit.
- `periodStart`, `periodEnd` — reporting period, or the balance sheet date.
- `location` — state or country code the company reports.

Fields without a value are left out.

## Credits

A search that returns at least one row uses 1 credit.
An empty search, a search that finds nothing, or a failed search uses 0.
Wrong input returns 400 with a message and uses 0.
No remaining credits returns 402 and does not search.
A missing key returns 401.

## Related

- https://skills.duaer.com/company-financials.md — Duaer Company financials (SEC)
- https://skills.duaer.com/world-bank.md — Duaer World Bank indicators

Questions

How many credits does a Company rankings (SEC) search use in Duaer?

One credit when Duaer returns rows. A search with no rows or an error uses 0.

How does Duaer Company rankings (SEC) align fiscal years?

It uses the SEC calendar-year frames. For a company whose fiscal year does not end in December, the closest annual period is used.

In this section

Get started

Company financials (SEC) in Duaer

In Duaer: SEC EDGAR XBRL: yearly or quarterly revenue, net income, EPS, assets, and cash of a US-listed company. One successful search uses 1 credit.

Get started

World Bank indicators in Duaer

In Duaer: Yearly development data for any country from the World Bank: GDP, population, inflation, trade, health, education, and 1,000+ other indicators by code. One successful search uses 1 credit.