Dokumen API dan MCP
FinancialMD menyediakan penyata kewangan yang dibina daripada pemfailan SEC. Setiap nombor dipautkan kepada pemfailan SEC asalnya, dan setiap nombor boleh dibaca seperti yang diketahui pada mana-mana tarikh. Tiada akaun diperlukan.
Buat panggilan pertama
API ialah JSON melalui HTTPS. Panggilan ini mengembalikan lima penyata pendapatan tahunan terakhir Apple. Ia tidak memerlukan kunci.
curl "https://api.financial.md/v1/company/financials/income_statement/standardized?company=ticker:AAPL&period_type=annual&limit=5"Penyata tersebut ialah income_statement, balance_sheet, cash_flow atau supplemental. Jenis tempoh ialah annual, quarterly, ltm atau ytd.
Namakan syarikat
Setiap laluan syarikat menerima parameter company.
ticker:AAPL, atauticker:AAPL.XNASuntuk menyatakan bursacik:320193, nombor syarikat SECfmd_<id>, id yang FinancialMD berikan kepada syarikat
AAPL tanpa awalan dibaca sebagai ticker dan digit sahaja sebagai CIK. Respons menyatakan padanan dalam meta.company.matched_by.
Baca nilai
Respons yang berjaya ialah { data, meta }. Nombor di dalam data tidak pernah berdiri sendiri. Ia ialah 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 ialah tempoh masa apabila ini merupakan angka terkini yang difailkan. restated adalah benar hanya apabila pemfailan SEC kemudian mengubah angka tersebut; restatement_kind kemudian menyatakan caranya. proof.id boleh diakses di GET /proof/{id} untuk mendapatkan pemfailan SEC dan fakta mentah di sebalik nilai itu.
Baca masa lalu seperti yang diketahui
as_of=2024-06-30pada mana-mana laluan baca mengembalikan apa yang diketahui pada masa itu.original=truemengembalikan versi pertama yang dilaporkan bagi setiap tempoh.history=truemengembalikan setiap versi setiap tempoh, yang paling lama dahulu.GET /v1/changes?since=<timestamp>menyenaraikan fakta yang dipelajari sejak itu.
Laluan API
| Laluan | Apa yang dikembalikan |
|---|---|
GET /v1/companies | Direktori syarikat dengan penapis dan penomboran halaman |
GET /v1/company/profile | Profil, senarai dan set data yang tersedia |
GET /v1/company/metrics | Baris konsep bagi templat syarikat |
GET /v1/company/financials/{statement}/standardized | Penyata piawai |
GET /v1/company/financials/{statement}/as_reported | Item baris milik pemfail dengan tag |
GET /v1/company/ratios | Nisbah yang dikira daripada penyata, dengan bukti inputnya |
GET /v1/company/ratios/daily/{ratio_id} | Satu nisbah sebagai siri sepanjang tempoh |
GET /v1/company/filings | Indeks pemfailan SEC sesebuah syarikat |
GET /v1/filing/{accession} | Satu pemfailan SEC |
GET /v1/filing/{accession}/facts | Setiap fakta dipetakan yang ditag oleh sesuatu pemfailan SEC |
GET /v1/filing/{accession}/document | Pautan ke halaman sesuatu pemfailan SEC di EDGAR, atau dokumen utamanya sebagai HTML, PDF atau imej halaman |
GET /v1/company/ownership/insiders | Transaksi orang dalam daripada Form 3, Form 4 dan Form 5 |
GET /v1/company/ownership/institutional | Pemegang Form 13F bagi sesebuah syarikat, mengikut suku tahun |
GET /v1/ownership/institutional/holders | Pengurus Form 13F |
GET /v1/ownership/institutional/holdings | Portfolio 13F seorang pengurus untuk satu suku tahun |
GET /v1/company/splits | Pecahan saham seperti yang difailkan, dan sama ada harga mengesahkannya |
GET /v1/company/dividends | Dividen setiap saham yang diisytiharkan atau dibayar dalam setiap tempoh, seperti yang difailkan |
GET /v1/events_calendar | Pengumuman pendapatan (8-K Item 2.02 difailkan) dan tarikh jangkaan model |
GET /v1/company/events | Item 8-K: suapan peristiwa berasaskan pemfailan SEC |
GET /v1/news | Pemfailan 8-K bagi setiap syarikat yang diliputi, terbaru dahulu, dengan jenis peristiwa dan tahap kepentingan |
GET /v1/news/feed | Suapan peristiwa FinancialMD sendiri daripada setiap borang SEC yang mengandungi peristiwa, dengan tajuk utama, kepentingan dan nombor utama yang dijana mengikut peraturan. Bukan berita wayar |
GET /v1/news/issuer_releases | Pengumuman yang diterbitkan oleh penerbit tentang diri mereka: eksibit SEC, serta tajuk utama dan pautan daripada suapan penerbit sendiri |
GET /v1/company/call_materials | Bahan panggilan pendapatan yang difailkan oleh penerbit dengan SEC: pengumuman, ucapan yang disediakan, surat, pembentangan, dan transkrip apabila ia difailkan |
GET /v1/call_material/{id} | Satu dokumen yang difailkan oleh penerbit sebagai petikan dengan bahagian, giliran penceramah dan tag topik |
GET /v1/calls_calendar | Panggilan pendapatan seperti yang diumumkan oleh penerbit dalam pemfailan SEC, dengan pautan ke halaman siaran web penerbit sendiri |
GET /v1/search/filings | Carian teks penuh dokumen EDGAR sejak 2001 (carian teks penuh SEC EDGAR) |
GET /v1/coverage | Setiap set data dengan statusnya: tersedia, tidak diliputi (berlesen) atau belum dibina, dan apa yang perlu digunakan sebagai gantinya |
GET /v1/company/estimates | Anggaran garis dasar berasaskan model FinancialMD sendiri dengan julat dan rekod prestasi pada titik masa tertentu (point-in-time), panduan syarikat seperti yang dinyatakan dalam pemfailannya, dan isyarat deskriptif. Bukan konsensus, bukan anggaran penganalisis. Lihat kaedah |
GET /v1/company/estimates/consensus | Tidak diliputi: anggaran konsensus adalah berlesen. Mengembalikan 404 not_covered dengan alternatif |
GET /v1/company/analyst_ratings | Tidak diliputi: penarafan penganalisis adalah berlesen. Mengembalikan 404 not_covered |
GET /v1/company/transcripts | Tidak diliputi: transkrip panggilan adalah berlesen. Mengembalikan 404 not_covered |
GET /v1/company/stock_prices/intraday | Tidak diliputi: harga masa nyata dan intrahari dilesenkan. Mengembalikan 404 not_covered |
GET /v1/company/logo | Logo untuk mengenal pasti syarikat: fail berlesen terbuka dengan atribusinya, atau jubin yang dijana. JSON, SVG atau PNG |
GET /v1/politician_trades | Dagangan oleh ahli Dewan Perwakilan AS yang dilaporkan dalam laporan transaksi berkala, seperti yang difailkan, bersama laporan rasmi. Tidak pernah diberi harga. Penggunaan dihadkan oleh 5 U.S.C. 13107(c)(1): baca data.notice |
GET /v1/company/segments | Fakta segmen seperti yang dilaporkan (perniagaan, geografi, produk) |
GET /v1/company/ownership/insider_holders | Apa yang dimiliki setiap orang dalam selepas Form 4 atau 5 terbaharu mereka |
GET /v1/company/ownership/funds | Dana yang memegang syarikat dalam Form N-PORT terbaharu mereka |
GET /v1/funds | Dana Form N-PORT dengan laporan terbaharu mereka |
GET /v1/fund/holdings | Pegangan Form N-PORT bagi satu dana |
GET /v1/company/kpis | Metrik pelarasan dan operasi yang dilaporkan oleh syarikat, setiap satu dengan petikannya |
GET /v1/company/dividend_events | Dividen tunai dengan tarikhnya seperti yang difailkan |
GET /v1/company/ownership/insider_holdings | Baris pegangan dalam Form 3, 4 dan 5 |
GET /v1/fund/profile | Jenis dana daripada N-CEN dan yuran kelas sahamnya |
GET /v1/fund/nav | Aset bersih dana mengikut bulan laporan, pulangan bulanan dilaporkan bagi setiap kelas dengan indeks pulangan kami, dan NAV sesaham dana tertutup, daripada pemfailan SEC. NAV harian tidak disediakan |
GET /v1/identifiers/xref | Diberikan satu pengecam, syarikat atau dana yang dirujuknya dan pengecam terbuka lain, masing-masing dengan sumbernya |
GET /v1/identifiers/master | Pengecam terbuka bagi setiap syarikat, berhalaman |
GET /v1/company/stock_prices/returns | Pulangan harga, pulangan keseluruhan dan susut nilai maksimum sepanjang tetingkap standard, dikira daripada bar akhir hari dan pemisahan saham serta dividen yang difailkan kepada SEC |
GET /v1/company/identifiers | LEI dan FIGI dengan bukti mereka |
GET /v1/company/stock_prices | Bar harian dibina daripada dagangan pada IEX sahaja. Bukan pita konsolidasi. Mentah secara lalai; adjust=splits atau adjust=total_return menambah nilai yang diselaraskan |
GET /v1/screen | Saring setiap syarikat yang diliputi berdasarkan metrik tempoh terkini |
POST /v1/verify | Semak nombor terhadap nilai yang difailkan |
GET /v1/changes | Fakta yang pengetahuannya menjadi terbuka sejak sesuatu masa |
POST /v1/request-data | Beritahu kami data apa yang anda perlukan dan tidak jumpa. Tiada kunci, tidak pernah dicaj, disemak setiap minggu. Lihat cara memohon |
GET /v1/request-data | Badan POST /v1/request-data menerima |
GET /v1/request-data/{id} | Status permintaan: baru, ditapis awal, dirancang, selesai atau wontfix |
GET /v1/requested | Diminta dan dihantar: permintaan disemak dengan kiraan, tiada butiran penghantar |
GET /proof/{id} | Bukti untuk nilai yang disediakan |
GET /v1/company/line_items | Satu baris yang dilaporkan mengikut label dan tempoh: baris terperinci seperti yang dilaporkan, angka segmen, metrik syarikat dan panduan |
GET /v1/screen/nl | Saringan bahasa biasa: soalan diuraikan kepada penapis saringan (oleh model AI atau peraturan tetap, berlabel) dan dijalankan sebagai GET /v1/screen |
GET /v1/ask | Jawapan bertulis AI tentang satu syarikat daripada nilai yang difailkannya sendiri, dengan setiap nombor disemak terhadap fakta yang dipetik |
GET /v1/news/summary | Ringkasan yang ditulis AI tentang berita berasaskan pemfailan SEC bagi satu hari, atau tentang peristiwa terkini satu syarikat, daripada suapan peristiwa FinancialMD sendiri; setiap poin memetik pemfailan SEC dan setiap nombor disemak terhadapnya |
GET /v1/company/ratios/forward | Nisbah penilaian hadapan berdasarkan anggaran berasaskan model kami sendiri (output model berlabel, bukan konsensus), dengan anggaran, julatnya dan rekod prestasinya |
GET /v1/company/technicals | Penunjuk teknikal (purata bergerak, RSI, MACD, jalur Bollinger, ATR, julat penutupan) dikira daripada bar harian satu venue dan pemisahan saham yang difailkan kepada SEC |
GET /v1/pre_ipo | Syarikat yang telah memfailkan untuk disenaraikan awam: pendaftar dengan S-1 atau F-1 dalam fail sebelum sebarang laporan berkala, dengan status, ticker yang dicadangkan dan tarikh |
GET /v1/pre_ipo/{cik} | Satu pendaftar pra-IPO: status dan peraturannya, pemfailan pendaftaran, angka kewangan yang ditandakan dan terma tawaran yang dibaca daripada prospektus |
GET /v1/fx_rates | Kadar pertukaran rujukan harian daripada fail awam Bank Pusat Eropah, mana-mana mata wang yang disediakan berbanding mana-mana mata wang lain melalui euro; kadar rujukan, bukan sebut harga boleh dagang |
GET /v1/research | Laporan penyelidikan bebas yang dilesenkan CC BY 4.0, juga boleh dibaca tanpa kos di laman penerbit mereka: cari mengikut syarikat, koleksi, bahasa, perkataan dan tarikh, setiap satu dengan ringkasan dalam kata-kata laporan itu sendiri |
GET /v1/research/{id} | Satu laporan penyelidikan penuh sebagai Markdown berstruktur: bahagian, ticker, tarikh, sumber, lesen dan atribusi yang perlu disimpan apabila memetiknya |
POST /v1/feedback | Beritahu kami apa yang berkesan dan apa yang tidak: nota, penarafan atau sebab. Tiada kunci, tidak pernah dicaj. GET /v1/feedback menerangkan badan permintaan |
POST /v1/data-errors | Laporkan nombor yang anda percaya salah. Ia dibandingkan dengan apa yang kami sediakan serta-merta dan dengan pemfailan SEC setiap hari. Ikuti dengan GET /v1/data-errors/{id} |
Dokumen OpenAPI mempunyai setiap parameter dan skema respons. llms.txt, llms-full.txt dan fail kemahiran menyatakan perkara yang sama untuk ejen; https://api.financial.md/docs ialah rujukan interaktif dan https://api.financial.md/changelog menyenaraikan perubahan.
Semak nombor
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}'Jawapannya mempunyai verdict matches, differs atau unknown, nilai yang difailkan bersama buktinya, perbezaan, dan scale_hint apabila nombor anda tersasar dengan kuasa sepuluh.
Had
Panggilan tanpa kunci dihadkan mengikut alamat IP, setiap hari.
- 10 panggilan bermeter: nisbah, saringan, semakan dan setiap laluan berharga, seperti penyata piawai, segmen dan KPI
- 1,000 bacaan lapisan pemfailan SEC: fakta seperti dilaporkan, pemfailan SEC, pemilikan dan harga
- 1,000 bacaan metadata: direktori, profil, metrik, bukti dan perubahan
Setiap respons membawa RateLimit-Limit, RateLimit-Remaining dan RateLimit-Reset. Respons 429 membawa Retry-After.
Panggilan pada api.financial.md tanpa kunci tidak pernah dikenakan caj. Kunci API disertakan dengan pelan Terminal + Ejen; lihat Kunci API. Ejen juga boleh membayar bagi setiap panggilan pada agent.financial.md. Lihat Harga.
Liputan
Liputan ialah syarikat yang memfailkan dengan SEC dan disenaraikan di bursa US hari ini.
- Penyata piawai wujud untuk syarikat yang melapor di bawah US GAAP.
- Syarikat yang melapor di bawah IFRS, seperti banyak syarikat asing yang memfailkan Form 20-F atau 40-F, mempunyai pemfailan SEC tetapi belum mempunyai penyata piawai.
- Syarikat yang telah dinyahsenarai ada dalam direktori bersama penyata dan pemfailan SEC mereka. Cari mengikut CIK: syarikat ini tiada carian ticker dan tiada harga, jadi sejarah harga hanya meliputi syarikat yang disenaraikan hari ini.
- Data pemilikan datang daripada pemfailan SEC yang dibuat sejak 1 Julai 2026, dan dikemas kini setiap hari pada 13:00 UTC daripada indeks harian EDGAR: urus niaga orang dalam daripada Form 3, Form 4 dan Form 5 syarikat yang diliputi, dan setiap 13F-HR, jadi laporan 13F bagi suku baharu tiba apabila pengurus memfailkannya. Kedudukan 13F dikaitkan dengan syarikat hanya apabila muka depan Schedule 13D atau 13G menamakan sekuritinya. Untuk suku berakhir 30 Jun 2026, ini mengaitkan 80 peratus daripada nilai yang dilaporkan; kedudukan lain muncul dalam portfolio pengurus di bawah nama penerbit seperti yang difailkan.
- Anggaran konsensus dan transkrip panggilan pendapatan tidak disediakan: kedua-duanya ialah data berlesen. Segmen disediakan seperti yang dilaporkan, dan berita ialah suapan pemfailan 8-K.
Apabila sesebuah syarikat diketahui tetapi set data tiada, API menjawab not_covered dan menyenaraikan set data yang dimilikinya.
Pelayan MCP
Pelayan MCP membungkus API yang sama dalam 57 alat baca sahaja. Ia menggunakan MCP Streamable HTTP dan tidak memerlukan akaun.
https://mcp.financial.md/mcpPanduan MCP menyenaraikan alat. Kad pelayan adalah untuk daftar.
Ralat
Ralat ialah { "error": { code, message, docs, request_id, remedies } }. Senarai remedies menyatakan perkara yang perlu dilakukan seterusnya. Rujukan ralat menerangkan setiap kod.