Langkau ke kandungan

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, atau ticker:AAPL.XNAS untuk menyatakan bursa
  • cik:320193, nombor syarikat SEC
  • fmd_<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-30 pada mana-mana laluan baca mengembalikan apa yang diketahui pada masa itu.
  • original=true mengembalikan versi pertama yang dilaporkan bagi setiap tempoh.
  • history=true mengembalikan setiap versi setiap tempoh, yang paling lama dahulu.
  • GET /v1/changes?since=<timestamp> menyenaraikan fakta yang dipelajari sejak itu.

Laluan API

LaluanApa yang dikembalikan
GET /v1/companiesDirektori syarikat dengan penapis dan penomboran halaman
GET /v1/company/profileProfil, senarai dan set data yang tersedia
GET /v1/company/metricsBaris konsep bagi templat syarikat
GET /v1/company/financials/{statement}/standardizedPenyata piawai
GET /v1/company/financials/{statement}/as_reportedItem baris milik pemfail dengan tag
GET /v1/company/ratiosNisbah yang dikira daripada penyata, dengan bukti inputnya
GET /v1/company/ratios/daily/{ratio_id}Satu nisbah sebagai siri sepanjang tempoh
GET /v1/company/filingsIndeks pemfailan SEC sesebuah syarikat
GET /v1/filing/{accession}Satu pemfailan SEC
GET /v1/filing/{accession}/factsSetiap fakta dipetakan yang ditag oleh sesuatu pemfailan SEC
GET /v1/filing/{accession}/documentPautan ke halaman sesuatu pemfailan SEC di EDGAR, atau dokumen utamanya sebagai HTML, PDF atau imej halaman
GET /v1/company/ownership/insidersTransaksi orang dalam daripada Form 3, Form 4 dan Form 5
GET /v1/company/ownership/institutionalPemegang Form 13F bagi sesebuah syarikat, mengikut suku tahun
GET /v1/ownership/institutional/holdersPengurus Form 13F
GET /v1/ownership/institutional/holdingsPortfolio 13F seorang pengurus untuk satu suku tahun
GET /v1/company/splitsPecahan saham seperti yang difailkan, dan sama ada harga mengesahkannya
GET /v1/company/dividendsDividen setiap saham yang diisytiharkan atau dibayar dalam setiap tempoh, seperti yang difailkan
GET /v1/events_calendarPengumuman pendapatan (8-K Item 2.02 difailkan) dan tarikh jangkaan model
GET /v1/company/eventsItem 8-K: suapan peristiwa berasaskan pemfailan SEC
GET /v1/newsPemfailan 8-K bagi setiap syarikat yang diliputi, terbaru dahulu, dengan jenis peristiwa dan tahap kepentingan
GET /v1/news/feedSuapan 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_releasesPengumuman yang diterbitkan oleh penerbit tentang diri mereka: eksibit SEC, serta tajuk utama dan pautan daripada suapan penerbit sendiri
GET /v1/company/call_materialsBahan 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_calendarPanggilan pendapatan seperti yang diumumkan oleh penerbit dalam pemfailan SEC, dengan pautan ke halaman siaran web penerbit sendiri
GET /v1/search/filingsCarian teks penuh dokumen EDGAR sejak 2001 (carian teks penuh SEC EDGAR)
GET /v1/coverageSetiap set data dengan statusnya: tersedia, tidak diliputi (berlesen) atau belum dibina, dan apa yang perlu digunakan sebagai gantinya
GET /v1/company/estimatesAnggaran 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/consensusTidak diliputi: anggaran konsensus adalah berlesen. Mengembalikan 404 not_covered dengan alternatif
GET /v1/company/analyst_ratingsTidak diliputi: penarafan penganalisis adalah berlesen. Mengembalikan 404 not_covered
GET /v1/company/transcriptsTidak diliputi: transkrip panggilan adalah berlesen. Mengembalikan 404 not_covered
GET /v1/company/stock_prices/intradayTidak diliputi: harga masa nyata dan intrahari dilesenkan. Mengembalikan 404 not_covered
GET /v1/company/logoLogo untuk mengenal pasti syarikat: fail berlesen terbuka dengan atribusinya, atau jubin yang dijana. JSON, SVG atau PNG
GET /v1/politician_tradesDagangan 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/segmentsFakta segmen seperti yang dilaporkan (perniagaan, geografi, produk)
GET /v1/company/ownership/insider_holdersApa yang dimiliki setiap orang dalam selepas Form 4 atau 5 terbaharu mereka
GET /v1/company/ownership/fundsDana yang memegang syarikat dalam Form N-PORT terbaharu mereka
GET /v1/fundsDana Form N-PORT dengan laporan terbaharu mereka
GET /v1/fund/holdingsPegangan Form N-PORT bagi satu dana
GET /v1/company/kpisMetrik pelarasan dan operasi yang dilaporkan oleh syarikat, setiap satu dengan petikannya
GET /v1/company/dividend_eventsDividen tunai dengan tarikhnya seperti yang difailkan
GET /v1/company/ownership/insider_holdingsBaris pegangan dalam Form 3, 4 dan 5
GET /v1/fund/profileJenis dana daripada N-CEN dan yuran kelas sahamnya
GET /v1/fund/navAset 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/xrefDiberikan satu pengecam, syarikat atau dana yang dirujuknya dan pengecam terbuka lain, masing-masing dengan sumbernya
GET /v1/identifiers/masterPengecam terbuka bagi setiap syarikat, berhalaman
GET /v1/company/stock_prices/returnsPulangan 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/identifiersLEI dan FIGI dengan bukti mereka
GET /v1/company/stock_pricesBar 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/screenSaring setiap syarikat yang diliputi berdasarkan metrik tempoh terkini
POST /v1/verifySemak nombor terhadap nilai yang difailkan
GET /v1/changesFakta yang pengetahuannya menjadi terbuka sejak sesuatu masa
POST /v1/request-dataBeritahu kami data apa yang anda perlukan dan tidak jumpa. Tiada kunci, tidak pernah dicaj, disemak setiap minggu. Lihat cara memohon
GET /v1/request-dataBadan POST /v1/request-data menerima
GET /v1/request-data/{id}Status permintaan: baru, ditapis awal, dirancang, selesai atau wontfix
GET /v1/requestedDiminta dan dihantar: permintaan disemak dengan kiraan, tiada butiran penghantar
GET /proof/{id}Bukti untuk nilai yang disediakan
GET /v1/company/line_itemsSatu baris yang dilaporkan mengikut label dan tempoh: baris terperinci seperti yang dilaporkan, angka segmen, metrik syarikat dan panduan
GET /v1/screen/nlSaringan bahasa biasa: soalan diuraikan kepada penapis saringan (oleh model AI atau peraturan tetap, berlabel) dan dijalankan sebagai GET /v1/screen
GET /v1/askJawapan bertulis AI tentang satu syarikat daripada nilai yang difailkannya sendiri, dengan setiap nombor disemak terhadap fakta yang dipetik
GET /v1/news/summaryRingkasan 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/forwardNisbah penilaian hadapan berdasarkan anggaran berasaskan model kami sendiri (output model berlabel, bukan konsensus), dengan anggaran, julatnya dan rekod prestasinya
GET /v1/company/technicalsPenunjuk 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_ipoSyarikat 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_ratesKadar 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/researchLaporan 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/feedbackBeritahu 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-errorsLaporkan 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/mcp

Panduan 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.