Dokumentasi API dan MCP

Lakukan panggilan pertama

API ini menggunakan JSON melalui HTTPS. Panggilan ini mengembalikan lima laporan laba rugi tahunan terakhir Apple. Tidak diperlukan kunci.

curl "https://api.financial.md/v1/company/financials/income_statement/standardized?company=ticker:AAPL&period_type=annual&limit=5"

Jenis laporan adalah salah satu dari income_statement, balance_sheet, cash_flow, atau supplemental. Jenis periode adalah salah satu dari annual, quarterly, ltm, atau ytd.

Tentukan perusahaan

Setiap rute perusahaan menerima parameter company.

• ticker:AAPL, atau ticker:AAPL.XNAS untuk menentukan bursa
• cik:320193, nomor perusahaan yang ditetapkan SEC
• fmd_<id>, ID yang diberikan FinancialMD kepada perusahaan

AAPL tanpa awalan dibaca sebagai simbol saham, dan angka tanpa awalan sebagai CIK. Respons menunjukkan dasar pencocokan di meta.company.matched_by.

Baca nilai

Respons yang berhasil berbentuk { data, meta }. Angka di dalam data tidak pernah berdiri sendiri. Angka tersebut berupa objek nilai:

{
  "value": 391035000000,
  "unit": "USD",
  "currency": "USD",
  "decimals": -6,
  "period": { "start": "2023-10-01", "end": "2024-09-28", "type": "annual", "fiscal_year": 2024, "fiscal_period": "FY" },
  "known": { "from": "YYYY-MM-DDThh:mm:ssZ", "to": null },
  "restated": false,
  "method": "as_filed",
  "calc_type": "as_filed",
  "proof": { "id": "p_...", "accession": "0000320193-24-000123", "form": "10-K", "filed": "2024-11-01", "taxonomy": "us-gaap", "tag": "...", "source_url": "https://www.sec.gov/..." }
}

known adalah rentang waktu ketika angka ini merupakan angka terbaru yang dilaporkan. restated bernilai true hanya jika dokumen pelaporan SEC berikutnya mengubah angka tersebut; restatement_kind kemudian menjelaskan bagaimana perubahan itu dilakukan. proof.id mengarah melalui GET /proof/{id} ke dokumen pelaporan SEC dan fakta mentah yang mendasari nilai tersebut.

Baca masa lalu sebagaimana diketahui saat itu

• as_of=2024-06-30 pada rute baca mana pun mengembalikan apa yang diketahui pada saat tersebut.
• original=true mengembalikan versi yang pertama kali dilaporkan untuk setiap periode.
• history=true mengembalikan semua versi untuk setiap periode, dari yang paling lama.
• GET /v1/changes?since=<timestamp> mencantumkan fakta yang diketahui sejak saat itu.

Rute

Dokumen OpenAPI memuat setiap parameter dan skema respons. llms.txt, llms-full.txt, dan berkas skill memuat informasi yang sama untuk agen; https://api.financial.md/docs adalah referensi interaktif dan https://api.financial.md/changelog mencantumkan perubahan.

Periksa angka

curl -X POST "https://api.financial.md/v1/verify" -H "content-type: application/json" \
  -d '{"company":"ticker:AAPL","concept":"income_statement_total_revenues","period":"FY2024","value":391035000000}'

Respons memuat verdict berupa matches, differs, atau unknown, nilai dalam dokumen pelaporan SEC beserta buktinya, selisihnya, serta scale_hint ketika angka Anda meleset dengan faktor pangkat sepuluh.

Batas

Panggilan tanpa kunci dibatasi per alamat IP, per hari.

• 25 panggilan terukur: rasio, penyaringan, dan verifikasi
• 1,000 pembacaan lapisan dokumen pelaporan SEC: laporan keuangan, fakta sebagaimana dilaporkan, dokumen pelaporan SEC, kepemilikan, dan harga
• 1,000 pembacaan metadata: direktori, profil, metrik, bukti, dan perubahan

Setiap respons menyertakan RateLimit-Limit, RateLimit-Remaining, dan RateLimit-Reset. Respons 429 menyertakan Retry-After.

Kunci API dengan batas lebih tinggi belum diterbitkan. Lihat Kunci API. Panggilan ke api.financial.md gratis. Agen dapat membayar per panggilan di agent.financial.md. Lihat Harga.

Apa saja yang dicakup

Cakupan meliputi perusahaan yang menyampaikan dokumen pelaporan SEC dan saat ini tercatat di bursa AS.

• Laporan keuangan terstandardisasi tersedia bagi pelapor yang menggunakan US GAAP.
• Pelapor yang menggunakan IFRS, seperti banyak perusahaan asing yang menyampaikan Form 20-F atau 40-F, memiliki dokumen pelaporan SEC tetapi belum memiliki laporan keuangan terstandardisasi.
• Perusahaan yang telah dihapus dari pencatatan bursa tersedia di direktori beserta laporan keuangan dan dokumen pelaporan SEC mereka. Cari berdasarkan CIK: perusahaan tersebut tidak dapat dicari berdasarkan ticker dan tidak memiliki data harga, sehingga riwayat harga hanya mencakup perusahaan yang tercatat saat ini.
• Data kepemilikan berasal dari dokumen pelaporan SEC yang disampaikan sejak July 1, 2026, dan diperbarui setiap hari pada 13:00 UTC dari indeks harian EDGAR: transaksi orang dalam dari Forms 3, 4 and 5 perusahaan dalam cakupan, serta setiap Form 13F-HR, sehingga laporan 13F untuk kuartal baru tersedia seiring manajer menyampaikannya. Posisi 13F dikaitkan dengan perusahaan hanya ketika halaman sampul Schedule 13D atau 13G menyebutkan efek perusahaan tersebut. Untuk kuartal yang berakhir pada June 30, 2026, pengaitan ini mencakup 80 persen dari nilai yang dilaporkan; posisi lainnya muncul dalam portofolio manajer dengan nama penerbit sebagaimana tercantum dalam dokumen pelaporan SEC.
• Estimasi konsensus dan transkrip paparan laba tidak disediakan: keduanya merupakan data berlisensi. Segmen disediakan sebagaimana dilaporkan, dan berita berupa umpan dokumen pelaporan SEC 8-K.

Jika suatu perusahaan diketahui tetapi suatu kumpulan data tidak tersedia, API menjawab not_covered dan mencantumkan kumpulan data yang tersedia.

Server MCP

Server MCP membungkus API yang sama dalam 50 alat hanya-baca. Server ini menggunakan MCP Streamable HTTP dan tidak memerlukan akun.

https://mcp.financial.md/mcp

Panduan MCP mencantumkan alat-alatnya. Kartu server ditujukan untuk registri.

Kesalahan

Kesalahan berbentuk { "error": { code, message, docs, request_id, remedies } }. Daftar remedies menjelaskan tindakan selanjutnya. Referensi kesalahan menjelaskan setiap kode.