ข้ามไปยังเนื้อหา

เอกสาร 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 หมายเลขบริษัทของ SEC
  • fmd_<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/identifiersLEI และ 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 อธิบายแต่ละโค้ด