Langkau ke kandungan

Permintaan data atau analisis

Beritahu kami apa yang anda perlukan dan tidak jumpa. Permintaan dibaca dalam ulasan mingguan, digabungkan dengan yang serupa, dan data yang paling banyak diminta oleh sumber awam dibina terlebih dahulu.

Bila untuk memohon

Hantar permintaan apabila set data, medan, syarikat atau analisis yang anda perlukan tiada, atau apabila sesuatu jawapan kelihatan salah. Orang menggunakan borang; ejen menggunakan API atau pelayan MCP. Kedua-duanya masuk ke baris gilir yang sama, dengan had yang sama.

Setiap keadaan syarikat kosong, tidak dilindungi dan tidak diketahui dalam terminal berakhir dengan pautan Request it yang mengisi borang untuk anda. Palet arahan juga menyenaraikan data atau analisis Request.

Jenis-jenis

baik hatiGunakan untuk
datasetSatu set data penuh yang kita kurang
fieldSatu item baris atau atribut
analysisPengiraan yang perlu dilakukan secara manual
coverageSyarikat, bursa atau negara yang kami tidak lindungi
bugJawapan yang salah atau rosak
otherApa-apa lagi

Gunakan borang

Borang Data atau analisis meminta jenis, apa yang anda perlukan, mengapa (pilihan) dan syarikat (pilihan). Jangan sertakan data peribadi dalam teks.

Anda akan dapat ID permintaan serta-merta. Simpan untuk semak status kemudian.

Hantar satu dari API

POST /v1/request-data mengambil kind dan want, dan secara pilihan why, company dan endpoint_or_tool. Ia tidak memerlukan kunci dan tidak pernah dikecas.

curl -X POST "https://api.financial.md/v1/request-data" -H "content-type: application/json" \
  -d '{"kind":"dataset","want":"Segment operating margin by quarter","why":"Comparing business lines","company":"ticker:AAPL"}'

Jawapannya ialah 201 dengan id permintaan, item permintaan yang disertai, statusnya dan berapa banyak yang ditanya setakat ini:

{
  "data": {
    "request_id": "0b8f6a52-6f0e-4a8e-9a43-3c0f6b2d1e11",
    "item_id": "7c2e0d4b-31a9-4f57-9a3e-5d0b8c1f2a64",
    "status": "new",
    "requests": 3,
    "requesters": 2,
    "status_url": "https://api.financial.md/v1/request-data/0b8f6a52-6f0e-4a8e-9a43-3c0f6b2d1e11",
    "served_by": null
  },
  "meta": { ... }
}

Sehingga 10 permintaan setiap alamat setiap UTC hari, 500 keseluruhannya. Selepas mana-mana had, jawapannya ialah 429 dengan Retry-After (rujuk rate_limited). GET /v1/request-data menerangkan badan.

Hantar satu daripada ejen

Seorang ejen menghantar permintaan dengan panggilan POST di atas. Pada pelayan MCP , alat request_status akan mencari satu melalui idnya. Jawapan yang tidak dipenuhi dari API membawa penyelesaian seperti request_data, jadi ejen tidak pernah terperangkap.

https://mcp.financial.md/mcp

Ikuti statusnya

Permintaan yang serupa digabungkan menjadi satu item permintaan, dikunci mengikut jenis, syarikat dan konsep; permintaan berulang menambah satu undi. Cari satu di halaman status atau dengan GET /v1/request-data/{id}:

curl "https://api.financial.md/v1/request-data/0b8f6a52-6f0e-4a8e-9a43-3c0f6b2d1e11"
StatusMaksud
newDiterima, belum disemak lagi
triagedDisemak dan digabungkan dengan permintaan serupa
plannedKami berniat untuk membinanya
doneDibina; served_by menamakan laluan atau alat yang berkhidmat untuknya
wontfixKami tidak akan membinanya; nota awam menyatakan sebabnya

Diminta dan dihantar

Halaman Diminta dan dihantar menyenaraikan item yang telah disemak dan diberi tajuk oleh pihak kami, dengan kiraan dan hasilnya. Item tidak pernah disenaraikan secara automatik. Ia hanya menunjukkan agregat: tiada penghantar, tiada teks yang dihantar. Data yang sama adalah suapan JSON :

curl "https://api.financial.md/v1/requested"

Log perubahan memaut ke papan tersebut, dan setiap item yang dihantar menyatakan apa yang menyediakannya.

Apa yang boleh kita bina

Kami membina daripada sumber awam terbuka dan analisis terbitan kami sendiri:

  • SEC EDGAR pemfailan dan set data (penyataan, pemilikan, acara, dana)
  • FRED dan statistik awam lain
  • Pengiraan ke atas data yang sudah kami sediakan (nisbah, skrin, perbandingan)

Data yang memerlukan lesen atau termanya melarang penggunaan semula, seperti anggaran konsensus, penarafan penganalisis atau suapan pertukaran masa nyata, ditandakan wontfix dengan nota yang menunjuk kepada GET /v1/coverage. Permintaan kemudian masih dikira sebagai undi, jadi kita tahu apa yang dikehendaki.

Privasi

Permintaan tidak meminta sebarang data peribadi. Alamat yang anda hantar hanya disimpan sebagai digest garam, untuk memenuhi had.

Borang ini pada masa ini tidak meminta alamat e-mel: ikuti permintaan melalui idnya. Jika e-mel balasan ditawarkan kemudian, ia adalah pilihan, dihantar hanya apabila anda menanda kotak, disimpan berasingan daripada permintaan, digunakan hanya untuk memberitahu anda apabila permintaan dihantar atau ditutup, dipadam apabila permintaan ditutup atau selepas 365 hari, dan tidak pernah dikongsi. Lihat Privasi.