เอกสาร API และ MCP
FinancialMD ให้บริการงบการเงินที่สร้างจากเอกสารที่ยื่นต่อ SEC ทุกตัวเลขเชื่อมโยงไปยังเอกสารที่ยื่นต่อ SEC ที่เป็นที่มาของตัวเลขนั้น และทุกตัวเลขสามารถอ่านได้ตามที่รับรู้ในวันใดก็ได้ ไม่ต้องมีบัญชี
เรียกใช้ครั้งแรก
API นี้ใช้ JSON ผ่าน HTTPS คำขอนี้จะส่งคืนงบกำไรขาดทุนรายปี 5 ฉบับล่าสุดของ Apple โดยไม่ต้องใช้คีย์
curl "https://api.financial.md/v1/company/financials/income_statement/standardized?company=ticker:AAPL&period_type=annual&limit=5"งบการเงินมีได้เป็น income_statement, balance_sheet, cash_flow หรือ supplemental ประเภทช่วงเวลามีได้เป็น annual, quarterly, ltm หรือ ytd.
ระบุบริษัท
ทุกเส้นทางของบริษัทใช้พารามิเตอร์ company.
ticker:AAPLหรือticker:AAPL.XNASเพื่อระบุตลาดหลักทรัพย์cik:320193หมายเลขบริษัทของ SECfmd_<id>คือ id ที่ FinancialMD กำหนดให้บริษัท
AAPL เปล่าจะถูกอ่านเป็น ticker และตัวเลขล้วนจะถูกอ่านเป็น CIK คำตอบจะบอกว่าสิ่งใดตรงกันใน meta.company.matched_by.
อ่านค่า
การตอบสนองที่สำเร็จคือ { data, meta } ตัวเลขใน data จะไม่มาแบบเดี่ยว ๆ แต่จะเป็น value object:
{
"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 คือช่วงเวลาที่ค่านี้เป็นตัวเลขล่าสุดที่ยื่นไว้ restated จะเป็น true ก็ต่อเมื่อเอกสารที่ยื่นต่อ SEC ฉบับหลังเปลี่ยนตัวเลขนี้; จากนั้น restatement_kind จะบอกว่าเปลี่ยนอย่างไร proof.id เรียกดูได้ที่ GET /proof/{id} ไปยังเอกสารที่ยื่นต่อ SEC และข้อเท็จจริงดิบที่อยู่เบื้องหลังค่านั้น
อ่านข้อมูลในอดีตตามที่เคยรับรู้
as_of=2024-06-30บนเส้นทางการอ่านใด ๆ จะคืนค่าตามที่เคยรับรู้ ณ ขณะนั้น.original=trueคืนเวอร์ชันที่รายงานครั้งแรกของแต่ละช่วงเวลาhistory=trueคืนทุกเวอร์ชันของแต่ละช่วงเวลา โดยเรียงจากเก่าที่สุดก่อนGET /v1/changes?since=<timestamp>แสดงรายการข้อเท็จจริงที่ได้ทราบตั้งแต่นั้นมา
เอ็นด์พอยต์
| เอ็นด์พอยต์ | สิ่งที่ส่งคืน |
|---|---|
GET /v1/companies | ไดเรกทอรีบริษัทพร้อมตัวกรองและการแบ่งหน้า |
GET /v1/company/profile | โปรไฟล์ รายการ และชุดข้อมูลที่มีให้ |
GET /v1/company/metrics | แถวแนวคิดของเทมเพลตของบริษัท |
GET /v1/company/financials/{statement}/standardized | งบการเงินมาตรฐาน |
GET /v1/company/financials/{statement}/as_reported | รายการบรรทัดของผู้ยื่นเอกสารเองพร้อมแท็ก |
GET /v1/company/ratios | อัตราส่วนที่คำนวณจากงบการเงิน พร้อมหลักฐานของอินพุต |
GET /v1/company/ratios/daily/{ratio_id} | อัตราส่วนหนึ่งเป็นชุดตามช่วงเวลา |
GET /v1/company/filings | ดัชนีเอกสารที่ยื่นต่อ SEC ของบริษัท |
GET /v1/filing/{accession} | เอกสารที่ยื่นต่อ SEC หนึ่งฉบับ |
GET /v1/filing/{accession}/facts | ข้อเท็จจริงที่แมปแล้วทุกข้อที่เอกสารที่ยื่นต่อ SEC ฉบับนั้นแท็กไว้ |
GET /v1/filing/{accession}/document | ลิงก์ไปยังหน้าของเอกสารที่ยื่นต่อ SEC บน EDGAR หรือเอกสารหลักในรูปแบบ HTML, PDF หรือภาพหน้าเอกสาร |
GET /v1/company/ownership/insiders | ธุรกรรมของบุคคลวงในจาก Form 3, Form 4 และ Form 5 |
GET /v1/company/ownership/institutional | ผู้ถือครอง Form 13F ของบริษัท แยกตามไตรมาส |
GET /v1/ownership/institutional/holders | ผู้จัดการ Form 13F |
GET /v1/ownership/institutional/holdings | พอร์ตโฟลิโอ 13F ของผู้จัดการหนึ่งคนสําหรับหนึ่งไตรมาส |
GET /v1/company/splits | การแตกหุ้นตามที่ยื่นไว้ และราคายืนยันหรือไม่ |
GET /v1/company/dividends | เงินปันผลต่อหุ้นที่ประกาศหรือจ่ายในแต่ละช่วงเวลา ตามที่ยื่น |
GET /v1/events_calendar | การประกาศผลประกอบการ (ยื่น 8-K Item 2.02) และวันที่แบบจำลองคาดไว้ |
GET /v1/company/events | รายการ 8-K: ฟีดเหตุการณ์ตามเอกสารที่ยื่นต่อ SEC |
GET /v1/news | เอกสาร 8-K ของทุกบริษัทที่ครอบคลุม โดยเรียงจากใหม่ล่าสุดก่อน พร้อมประเภทเหตุการณ์และระดับความสำคัญ |
GET /v1/news/feed | ฟีดเหตุการณ์ของ FinancialMD จากแบบฟอร์ม SEC ทุกแบบที่มีเหตุการณ์ พร้อมพาดหัวที่สร้างตามกฎ ระดับความสำคัญ และตัวเลขสำคัญ ไม่ใช่ข่าวจากสำนักข่าว |
GET /v1/news/issuer_releases | ประกาศที่ผู้ออกหลักทรัพย์เผยแพร่เกี่ยวกับตนเอง: เอกสารแนบของ SEC และพาดหัวพร้อมลิงก์จากฟีดของผู้ออกหลักทรัพย์เอง |
GET /v1/company/call_materials | เอกสารประกอบการประชุมชี้แจงผลประกอบการที่ผู้ออกหลักทรัพย์ยื่นต่อ SEC: ข่าวประชาสัมพันธ์ คำกล่าวที่เตรียมไว้ จดหมาย งานนำเสนอ และบทถอดความเมื่อมีการยื่น |
GET /v1/call_material/{id} | เอกสารหนึ่งฉบับที่ผู้ออกหลักทรัพย์ยื่น แบ่งเป็นช่วงข้อความพร้อมส่วนต่าง ๆ ช่วงผู้พูด และแท็กหัวข้อ |
GET /v1/calls_calendar | การประชุมชี้แจงผลประกอบการตามที่ผู้ออกหลักทรัพย์ประกาศในเอกสารที่ยื่นต่อ SEC พร้อมลิงก์ไปยังหน้าเว็บแคสต์ของผู้ออกหลักทรัพย์เอง |
GET /v1/search/filings | การค้นหาเอกสาร EDGAR แบบข้อความเต็มตั้งแต่ปี 2001 (การค้นหาแบบข้อความเต็มของ SEC EDGAR) |
GET /v1/coverage | ชุดข้อมูลทุกชุดพร้อมสถานะ: ให้บริการ, ไม่ครอบคลุม (มีลิขสิทธิ์) หรือยังไม่ได้สร้าง และสิ่งที่ควรใช้แทน |
GET /v1/company/estimates | ประมาณการฐานจากแบบจำลองของ FinancialMD พร้อมช่วงค่าและประวัติผลงานแบบ ณ จุดเวลา (point-in-time), แนวทางของบริษัทตามที่ระบุไว้ในเอกสารที่ยื่นต่อ SEC และสัญญาณเชิงพรรณนา ไม่ใช่ฉันทามติ ไม่ใช่ประมาณการของนักวิเคราะห์ ดู วิธีการ |
GET /v1/company/estimates/consensus | ไม่ครอบคลุม: ประมาณการฉันทามติมีลิขสิทธิ์ ตอบกลับ 404 not_covered พร้อมทางเลือกอื่น |
GET /v1/company/analyst_ratings | ไม่ครอบคลุม: คำแนะนำนักวิเคราะห์มีลิขสิทธิ์ ตอบกลับ 404 not_covered |
GET /v1/company/transcripts | ไม่ครอบคลุม: บทถอดความการประชุมสายมีลิขสิทธิ์ ตอบกลับ 404 not_covered |
GET /v1/company/stock_prices/intraday | ไม่ครอบคลุม: ราคาแบบเรียลไทม์และระหว่างวันเป็นข้อมูลที่มีลิขสิทธิ์ ตอบกลับ 404 not_covered |
GET /v1/company/logo | โลโก้เพื่อระบุบริษัท: ไฟล์ที่เปิดให้ใช้ภายใต้สัญญาอนุญาต พร้อมการระบุแหล่งที่มา หรือไทล์ที่สร้างขึ้น JSON, SVG หรือ PNG |
GET /v1/politician_trades | รายการซื้อขายของสมาชิกสภาผู้แทนราษฎรสหรัฐฯ ที่รายงานใน periodic transaction reports ตามที่ยื่นไว้ พร้อมรายงานทางการ ไม่ระบุราคา การใช้งานถูกจำกัดโดย 5 U.S.C. 13107(c)(1): อ่าน data.notice |
GET /v1/company/segments | ข้อมูลส่วนงานตามที่รายงาน (ธุรกิจ ภูมิศาสตร์ ผลิตภัณฑ์) |
GET /v1/company/ownership/insider_holders | สิ่งที่ insider แต่ละรายถือครองหลัง Form 4 หรือ Form 5 ล่าสุด |
GET /v1/company/ownership/funds | กองทุนที่ถือครองบริษัทนี้ใน Form N-PORT ล่าสุด |
GET /v1/funds | กองทุน Form N-PORT พร้อมรายงานล่าสุดของแต่ละกอง |
GET /v1/fund/holdings | การถือครองของกองทุนหนึ่งกองใน Form N-PORT |
GET /v1/company/kpis | ตัวชี้วัดที่ปรับปรุงแล้วและตัวชี้วัดการดำเนินงานที่บริษัทรายงาน โดยแต่ละรายการมีแหล่งอ้างอิง |
GET /v1/company/dividend_events | เงินปันผลเงินสดพร้อมวันที่ตามที่ยื่นไว้ |
GET /v1/company/ownership/insider_holdings | รายการถือครองใน Forms 3, 4 และ 5 |
GET /v1/fund/profile | ประเภทของกองทุนจาก N-CEN และค่าธรรมเนียมของแต่ละชนิดหน่วยลงทุน |
GET /v1/fund/nav | สินทรัพย์สุทธิของกองทุนแยกตามเดือนที่รายงาน ผลตอบแทนรายเดือนที่รายงานของแต่ละชนิดหน่วยลงทุนพร้อมดัชนีผลตอบแทนของเรา และ NAV ต่อหุ้นของกองทุนปิด จากเอกสารที่ยื่นต่อ SEC ไม่ให้บริการ NAV รายวัน |
GET /v1/identifiers/xref | เมื่อให้ตัวระบุมา 1 ตัว จะคืนบริษัทหรือกองทุนที่ตัวระบุนั้นอ้างถึง และตัวระบุแบบเปิดอื่น ๆ พร้อมแหล่งที่มาของแต่ละตัว |
GET /v1/identifiers/master | ตัวระบุแบบเปิดของทุกบริษัท แบบแบ่งหน้า |
GET /v1/company/stock_prices/returns | ผลตอบแทนราคา ผลตอบแทนรวม และการปรับตัวลงสูงสุดในช่วงเวลามาตรฐาน คำนวณจากแท่งราคาสิ้นวัน และการแตกหุ้นกับเงินปันผลที่ยื่นต่อ SEC |
GET /v1/company/identifiers | LEI และ FIGI พร้อมหลักฐานของแต่ละรายการ |
GET /v1/company/stock_prices | แท่งราคารายวันที่สร้างจากการซื้อขายบน IEX เท่านั้น ไม่ใช่ consolidated tape เป็นค่าดิบโดยค่าเริ่มต้น; adjust=splits หรือ adjust=total_return จะเพิ่มค่าที่ปรับแล้ว |
GET /v1/screen | คัดกรองบริษัทที่ครอบคลุมทุกแห่งตามตัวชี้วัดช่วงเวลาล่าสุด |
POST /v1/verify | ตรวจสอบตัวเลขกับค่าที่ยื่นไว้ |
GET /v1/changes | ข้อเท็จจริงที่เริ่มเป็นที่รู้ ณ เวลาหลังจากเวลาที่กำหนด |
POST /v1/request-data | บอกเราว่าคุณต้องการข้อมูลอะไรและหาไม่พบ ไม่ต้องใช้คีย์ ไม่คิดค่าบริการ ตรวจสอบทุกสัปดาห์ ดู วิธีขอ |
GET /v1/request-data | เนื้อหาของ POST /v1/request-data รับค่า |
GET /v1/request-data/{id} | สถานะของคําขอ: ใหม่, คัดกรองแล้ว, วางแผนไว้, เสร็จแล้ว หรือไม่แก้ไข |
GET /v1/requested | คำขอที่ส่งเข้ามาและที่ส่งมอบแล้ว: คำขอที่ตรวจสอบแล้วพร้อมจำนวน โดยไม่มีรายละเอียดของผู้ส่งคำขอ |
GET /proof/{id} | หลักฐานสําหรับมูลค่าที่ให้บริการ |
GET /v1/company/line_items | ข้อมูลที่รายงาน 1 รายการตามป้ายชื่อและงวด: รายการรายละเอียดตามที่รายงาน ตัวเลขส่วนงาน ตัวชี้วัดบริษัท และแนวโน้มที่บริษัทให้ไว้ |
GET /v1/screen/nl | ตัวคัดกรองแบบภาษาธรรมดา: คำถามจะถูกแยกเป็นตัวกรองสำหรับคัดกรอง (โดยโมเดล AI หรือกฎตายตัว พร้อมป้ายกำกับ) แล้วรันเป็น GET /v1/screen |
GET /v1/ask | คำตอบที่ AI เขียนเกี่ยวกับบริษัทหนึ่ง จากค่าที่บริษัทยื่นไว้เอง โดยตรวจสอบตัวเลขทุกตัวกับข้อเท็จจริงที่อ้างอิง |
GET /v1/news/summary | สรุปข่าวจากเอกสารที่ยื่นต่อ SEC ในวันเดียวกัน หรือเหตุการณ์ล่าสุดของบริษัทหนึ่งแห่ง ที่เขียนโดย AI จากฟีดเหตุการณ์ของ FinancialMD เอง; ทุกหัวข้อย่อยอ้างอิงเอกสารที่ยื่นต่อ SEC และทุกตัวเลขได้รับการตรวจสอบเทียบกับเอกสารเหล่านั้น |
GET /v1/company/ratios/forward | อัตราส่วนมูลค่าล่วงหน้าจากประมาณการตามโมเดลของเราเอง (ระบุชัดว่าเป็นผลลัพธ์จากโมเดล ไม่ใช่ฉันทามติ) พร้อมค่าประมาณ ช่วงประมาณการ และผลงานย้อนหลัง |
GET /v1/company/technicals | ตัวชี้วัดทางเทคนิค (ค่าเฉลี่ยเคลื่อนที่, RSI, MACD, แถบโบลลิงเจอร์, ATR, ช่วงของราคาปิด) คำนวณจากแท่งราคารายวันของตลาดเดียวและการแตกหุ้นที่ยื่นต่อ SEC |
GET /v1/pre_ipo | บริษัทที่ยื่นเพื่อเข้าตลาดหลักทรัพย์: ผู้จดทะเบียนที่มี S-1 หรือ F-1 อยู่ในระบบก่อนรายงานงวดใด ๆ พร้อมสถานะ ticker ที่เสนอ และวันที่ |
GET /v1/pre_ipo/{cik} | ผู้จดทะเบียนก่อน IPO 1 ราย: สถานะและกฎที่ใช้ เอกสารจดทะเบียน ตัวเลขทางการเงินที่ติดแท็กไว้ และเงื่อนไขการเสนอขายที่อ่านจากหนังสือชี้ชวน |
GET /v1/fx_rates | อัตราแลกเปลี่ยนอ้างอิงรายวันจากไฟล์สาธารณะของธนาคารกลางยุโรป สำหรับทุกคู่สกุลเงินที่ให้บริการผ่านยูโร; เป็นอัตราอ้างอิง ไม่ใช่ราคาที่ใช้ซื้อขายได้ |
GET /v1/research | รายงานวิจัยอิสระที่ได้รับอนุญาต CC BY 4.0 และสามารถอ่านได้โดยไม่มีค่าใช้จ่ายบนเว็บไซต์ของผู้จัดพิมพ์: ค้นหาตามบริษัท คอลเลกชัน ภาษา คํา และวันที่ โดยแต่ละฉบับมีสรุปด้วยถ้อยคําของรายงานเอง |
GET /v1/research/{id} | รายงานวิจัยฉบับเต็ม 1 ฉบับในรูปแบบ Markdown แบบมีโครงสร้าง: ส่วนต่าง ๆ, ticker, วันที่, แหล่งข้อมูล, ใบอนุญาต และการระบุแหล่งที่มาที่ต้องเก็บไว้เมื่ออ้างอิง |
POST /v1/feedback | บอกเราว่าอะไรได้ผลและอะไรไม่ได้ผล: หมายเหตุ คะแนน หรือเหตุผล ไม่ต้องใช้คีย์, ไม่คิดค่าใช้จ่าย GET /v1/feedback อธิบาย body |
POST /v1/data-errors | รายงานตัวเลขที่คุณเชื่อว่าไม่ถูกต้อง ระบบจะเปรียบเทียบทันทีทั้งกับข้อมูลที่เราให้บริการและกับเอกสารที่ยื่นต่อ SEC เป็นรายวัน ติดตามผลได้ด้วย GET /v1/data-errors/{id} |
เอกสาร OpenAPI มีทุกพารามิเตอร์และสคีมาการตอบกลับ llms.txt, llms-full.txt และไฟล์ทักษะ ระบุสิ่งเดียวกันสำหรับเอเจนต์; https://api.financial.md/docs คือเอกสารอ้างอิงแบบโต้ตอบ และ https://api.financial.md/changelog แสดงรายการการเปลี่ยนแปลง
ตรวจสอบตัวเลข
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}'คำตอบมี verdict เป็น matches, differs หรือ unknown, ค่าที่ยื่นพร้อมหลักฐาน, ความแตกต่าง และ scale_hint เมื่อจำนวนของคุณคลาดเคลื่อนด้วยกำลังสิบ
ข้อจำกัด
การเรียกโดยไม่ใช้คีย์จะถูกจำกัดตามที่อยู่ IP ต่อวัน.
- การเรียกแบบคิดโควตา 10 ครั้ง: ratios, screen, verify และทุก route ที่มีราคา เช่น งบการเงินมาตรฐาน, segments และ KPI
- การอ่านชั้นเอกสารที่ยื่นต่อ SEC 1,000 ครั้ง: ข้อเท็จจริงตามที่รายงาน, เอกสารที่ยื่นต่อ SEC, การถือครอง และราคา
- การอ่าน metadata 1,000 ครั้ง: directory, profiles, metrics, proofs และ changes
ทุกคำตอบจะมี RateLimit-Limit, RateLimit-Remaining และ RateLimit-Reset ส่วน 429 จะมี Retry-After.
การเรียกบน api.financial.md โดยไม่ใช้คีย์ไม่มีการเรียกเก็บเงิน API keys มาพร้อมกับแผน Terminal + Agent; ดู API keys. เอเจนต์ยังสามารถจ่ายต่อการเรียกบน agent.financial.md ได้ ดู Pricing.
สิ่งที่ครอบคลุม
ความครอบคลุมคือบริษัทที่ยื่นต่อ SEC และจดทะเบียนอยู่ในตลาดหลักทรัพย์สหรัฐวันนี้.
- มีงบการเงินมาตรฐานสำหรับผู้ยื่นที่รายงานภายใต้ US GAAP.
- ผู้ยื่นที่รายงานภายใต้ IFRS เช่น บริษัทต่างประเทศหลายแห่งที่ยื่น 20-F หรือ 40-F มีเอกสารที่ยื่นต่อ SEC แต่ยังไม่มีงบการเงินมาตรฐาน
- บริษัทที่ถูกเพิกถอนจากตลาดหลักทรัพย์ยังอยู่ในไดเรกทอรีพร้อมงบการเงินและเอกสารที่ยื่นต่อ SEC ค้นหาได้ด้วย CIK: บริษัทเหล่านี้ไม่มีการค้นหาด้วย ticker และไม่มีราคา ดังนั้นประวัติราคาจึงครอบคลุมเฉพาะบริษัทที่ยังจดทะเบียนอยู่ในปัจจุบันเท่านั้น
- ข้อมูลการถือครองมาจากเอกสารที่ยื่นตั้งแต่วันที่ 1 กรกฎาคม 2026 และอัปเดตทุกวันเวลา 13:00 UTC จากดัชนีรายวันของ EDGAR: ธุรกรรมของ insider จาก Form 3, Form 4 และ Form 5 ของบริษัทที่ครอบคลุม และทุก 13F-HR ดังนั้นรายงาน 13F ของไตรมาสใหม่จะเข้ามาเมื่อผู้จัดการยื่น เอกสาร ตำแหน่ง 13F จะผูกกับบริษัทได้ก็ต่อเมื่อหน้าปกของ Schedule 13D หรือ 13G ระบุชื่อหลักทรัพย์นั้น สำหรับไตรมาสสิ้นสุดวันที่ 30 มิถุนายน 2026 วิธีนี้ผูกได้ 80 เปอร์เซ็นต์ของมูลค่าที่รายงาน; ตำแหน่งที่เหลือจะปรากฏในพอร์ตของผู้จัดการภายใต้ชื่อผู้ออกหลักทรัพย์ตามที่ยื่น
- ไม่ได้ให้บริการประมาณการแบบ consensus และบทถอดความการประชุมผลประกอบการ: ทั้งสองอย่างเป็นข้อมูลที่มีลิขสิทธิ์ ส่วน segments ให้บริการตามที่รายงาน และข่าวคือฟีดของเอกสาร 8-K
เมื่อบริษัทเป็นที่รู้จักแต่ขาดชุดข้อมูล API จะตอบ not_covered และแสดงชุดข้อมูลที่มีอยู่
เซิร์ฟเวอร์ MCP
เซิร์ฟเวอร์ MCP ครอบ API เดียวกันไว้ในเครื่องมือแบบอ่านอย่างเดียว 57 ตัว รองรับ MCP Streamable HTTP และไม่ต้องใช้บัญชี
https://mcp.financial.md/mcpคู่มือ MCP แสดงรายการเครื่องมือ เซิร์ฟเวอร์การ์ด มีไว้สำหรับรีจิสทรี
ข้อผิดพลาด
รูปแบบข้อผิดพลาดคือ { "error": { code, message, docs, request_id, remedies } } รายการ remedies จะบอกว่าควรทำอะไรต่อไป error reference อธิบายแต่ละโค้ด