[ blog · comparison ]9 min read

API Fundamental Perusahaan: Neraca, Arus Kas & Transaksi Insider untuk Agen Keuangan

Sarah ChoyDiterbitkan 16 Juni 20269 menit baca
API Fundamental Perusahaan: Neraca, Arus Kas & Transaksi Insider untuk Agen Keuangan

Harga memberi tahu apa yang dipikirkan pasar; fundamental memberi tahu apakah pasar benar. Inilah API fundamental yang dibentuk untuk agen AI — laporan keuangan, dividen, dan transaksi insider dalam satu endpoint — dan bagaimana perbandingannya dengan SEC EDGAR mentah serta vendor API laporan.

TL;DR

  • Fundamental = lapisan 'apakah bisnisnya benar-benar sehat': neraca, laporan laba rugi, arus kas, dividen, transaksi insider.
  • Anda bisa mem-parsing-nya gratis dari SEC EDGAR (XBRL), tetapi menormalkan XBRL lintas filer dan periode adalah pekerjaan rekayasa yang nyata dan berkelanjutan — dan hanya untuk AS serta mengikuti ritme filing, bukan dibentuk untuk kueri.
  • Financials Search dari API Pick mengembalikan kelima fundamental perusahaan AS di balik satu endpoint POST — 200 kredit/panggilan, only-on-success — sudah dibentuk untuk penalaran LLM.
  • Transaksi insider (Form 4) dan riwayat dividen adalah sinyal yang kurang dimanfaatkan: murah diambil di sini, menyakitkan untuk dirakit dari EDGAR.
  • Padukan Financials dengan SEC Filings (teks kualitatif 10-K/10-Q) dan Markets (harga) untuk pandangan ber-grounding yang lengkap.

Harga adalah opini; fundamental adalah bukti

Sebuah panggilan data pasar memberi tahu agen Anda berapa harga sebuah saham. Ia tidak bisa memberi tahu apakah bisnis di baliknya sedang bertumbuh, tenggelam dalam utang, atau diam-diam dijual oleh para eksekutifnya sendiri. Itulah lapisan fundamental — dan di situlah agen riset beralih dari "mengutip harga" menjadi "membentuk pandangan".

Lima dataset membawa sebagian besar sinyal: neraca, laporan laba rugi, laporan arus kas, riwayat dividen, dan transaksi insider.

Pajak EDGAR

Semua ini bersifat publik dan gratis di SEC EDGAR. Masalahnya adalah XBRL. JSON company-facts sangat besar dan tidak konsisten: konsep yang sama diberi tag berbeda lintas filer, restatement mengeruhkan riwayat, dan Anda harus memetakan taksonomi yang berserakan ke skema yang bersih sebelum apa pun di hilir dapat memakainya. Data insider (Form 4) dan dividen adalah jenis filing terpisah yang Anda parsing sendiri-sendiri. Melakukan ini sekali untuk satu ticker adalah satu akhir pekan; melakukannya secara andal untuk agen yang mengueri perusahaan mana pun adalah sebuah pipeline yang dipelihara.

Fundamental sebagai satu alat

Financials Search mengembalikan neraca, laporan laba rugi, arus kas, dividen, dan transaksi insider untuk perusahaan publik AS di balik satu endpoint POST — 200 kredit per panggilan, only-on-success, sudah dibentuk untuk LLM.

import httpx, os
API, HEADERS = "https://api.apipick.com/v1", {"x-api-key": os.environ["APIPICK_KEY"]}

def fundamentals(query: str):
    return httpx.post(f"{API}/search/financials", headers=HEADERS,
                      json={"query": query}).json()["results"]

fundamentals("Apple latest balance sheet and cash flow")
fundamentals("recent insider transactions at Meta")
fundamentals("Microsoft revenue and net income trend")

EDGAR vs. vendor vs. suite

Parsing SEC EDGARVendor API laporanAPI Pick Financials
BiayaGratis + rekayasaLangganan200 kredit/panggilan, hanya jika berhasil
PenyiapanPipeline normalisasi XBRLIntegrasikan endpoint ter-typedSatu endpoint, satu bentuk
CakupanAS, diorganisasikan per filingMendalam, riwayat panjangFundamental AS + insider + dividen
Gaya kueriPer filing/konsepParameter ter-typedBahasa alami
Paling cocok untukSekali pakai / kendali penuhFundamental sebagai produkAgen keuangan (satu dari banyak alat)

Gambaran lengkap

Fundamental berpadu secara alami dengan SEC Filings Search untuk sisi kualitatif (faktor risiko, MD&A, bahasa earnings call) dan dengan Markets Search untuk harga. Bersama-sama, ketiganya adalah tulang punggung agen riset investasi. Satu kunci, JSON dari awal hingga akhir, only-on-success. Mulai gratis dengan 100 kredit, tanpa kartu.

Pertanyaan yang Sering Diajukan

Bukankah saya bisa mendapatkan fundamental gratis dari SEC EDGAR?

Bisa — data company-facts dan XBRL dari EDGAR gratis dan otoritatif. Biayanya adalah rekayasa: tag XBRL bergeser lintas filer dan periode, restatement membuat riwayat rumit, dan Anda harus memetakan ribuan konsep taksonomi ke skema yang bersih sebelum sebuah model (atau grafik) dapat menggunakannya. Ini juga hanya untuk AS dan diorganisasikan menurut filing, bukan menurut pertanyaan. Untuk satu perusahaan sesekali, EDGAR sudah cukup. Untuk agen yang mengueri banyak perusahaan dalam bahasa alami, API yang ternormalisasi menghemat berminggu-minggu.

Apa saja yang tercakup — dan apakah hanya untuk AS?

Neraca, laporan laba rugi, laporan arus kas, riwayat dividen, dan transaksi insider untuk perusahaan publik yang terdaftar di AS. Ini adalah fundamental AS; untuk penerbit non-AS Anda akan memakai sumber yang berbeda. Untuk teks filing-nya sendiri (faktor risiko 10-K, MD&A 10-Q, earnings call), gunakan endpoint terpisah SEC Filings Search.

Mengapa transaksi insider dan dividen layak disorot?

Keduanya bersinyal tinggi dan merepotkan untuk dirakit sendiri. Pembelian/penjualan insider (Form 4 SEC) adalah sinyal perilaku yang banyak dipantau; riwayat dividen penting untuk screen pendapatan dan kualitas. Keduanya menuntut mem-parsing jenis filing tertentu dari EDGAR. Di sini keduanya adalah field kelas satu pada endpoint yang sama dengan laporan keuangan.

Bagaimana perbandingannya dengan vendor API laporan keuangan?

Vendor khusus (mis. API laporan keuangan) memberikan endpoint yang mendalam dan ter-typed serta riwayat panjang — bagus jika fundamental adalah keseluruhan produk Anda. Sudut pandang API Pick berbeda: fundamental sebagai satu alat di antara satu suite (markets, SEC, ekonomi, berita) di balik satu kunci, dibentuk untuk kueri seorang agen, ditagih only-on-success. Jika Anda membangun agen keuangan alih-alih produk fundamental, suite-dalam-satu-bentuk adalah jalur yang lebih cepat.

Apakah ini nasihat investasi?

Bukan. Ini adalah data keuangan publik terstruktur untuk riset dan grounding agen. Ini menginformasikan analisis oleh orang yang berkualifikasi atau agen yang diawasi; ini bukan nasihat dan tidak boleh menjalankan trading otomatis tanpa akuntabilitas manusia dan kontrol risiko.

API yang digunakan dalam artikel ini

Sarah Choy
Ditulis oleh
Sarah Choy
CEO, API Pick

Sarah Choy adalah CEO API Pick. Ia menulis tentang membangun API siap produksi untuk AI agent dan alur kerja LLM.