Minta data atau analisis

Kapan mengajukan permintaan

Kirim permintaan jika kumpulan data, bidang, perusahaan, atau analisis yang Anda butuhkan belum tersedia, atau jika jawaban tampak salah. Pengguna memakai formulir; agen memakai API atau server MCP. Keduanya masuk ke antrean yang sama, dengan batas yang sama.

Setiap tampilan kosong, belum tercakup, dan perusahaan tidak dikenal di terminal diakhiri dengan tautan Minta yang mengisi formulir untuk Anda. Palet perintah juga mencantumkan Minta data atau analisis.

Jenis

Gunakan formulir

Formulir Minta data atau analisis meminta jenis, apa yang Anda butuhkan, alasan (opsional), dan perusahaan (opsional). Jangan sertakan data pribadi dalam teks.

Anda langsung mendapatkan ID permintaan. Simpan untuk memeriksa statusnya nanti.

Kirim permintaan melalui API

POST /v1/request-data menerima kind dan want, serta secara opsional why, company, dan endpoint_or_tool. Ini tidak memerlukan kunci dan tidak pernah dikenai biaya.

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"}'

Responsnya adalah 201 dengan ID permintaan, item kebutuhan tempat permintaan itu digabungkan, statusnya, dan jumlah yang telah meminta sejauh 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": { ... }
}

Maksimal 10 permintaan per alamat per hari UTC, 500 secara keseluruhan. Jika salah satu batas terlampaui, responsnya adalah 429 dengan Retry-After (lihat rate_limited). GET /v1/request-data menjelaskan isi permintaan.

Kirim permintaan melalui agen

Server MCP memiliki dua alat untuk ini: request_data mengirim permintaan dengan bidang yang sama, dan request_status mencari permintaan berdasarkan ID-nya. Jawaban API yang belum memenuhi kebutuhan menyertakan solusi berjenis request_data, sehingga agen tidak pernah buntu.

https://mcp.financial.md/mcp

Pantau statusnya

Permintaan serupa digabungkan menjadi satu item kebutuhan, dengan kunci berdasarkan jenis, perusahaan, dan konsep; permintaan berulang menambahkan satu suara. Cari permintaan di halaman status atau dengan GET /v1/request-data/{id}:

curl "https://api.financial.md/v1/request-data/0b8f6a52-6f0e-4a8e-9a43-3c0f6b2d1e11"

Diminta dan dirilis

Halaman Diminta dan dirilis mencantumkan item yang telah ditinjau dan diberi judul oleh seseorang dari pihak kami, beserta jumlah permintaan dan hasilnya. Item tidak pernah dicantumkan secara otomatis. Halaman ini hanya menampilkan data agregat: tanpa identitas pengirim, tanpa teks yang dikirimkan. Data yang sama tersedia sebagai umpan JSON:

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

Catatan perubahan menautkan ke papan tersebut, dan setiap item yang dirilis menyebutkan apa yang menyediakannya.

Yang dapat kami kembangkan

Kami mengembangkan dari sumber publik gratis dan analisis turunan kami sendiri:

• Dokumen pelaporan SEC dan kumpulan data dari SEC EDGAR (laporan keuangan, kepemilikan, peristiwa, dana investasi)
• FRED dan statistik publik lainnya
• Perhitungan atas data yang sudah kami sediakan (rasio, penyaringan, perbandingan)

Data yang memerlukan lisensi atau yang ketentuannya melarang penggunaan ulang, seperti estimasi konsensus, peringkat analis, atau umpan data bursa waktu nyata, ditandai wontfix dengan catatan yang mengarahkan ke GET /v1/coverage. Permintaan berikutnya untuk data tersebut tetap dihitung sebagai suara, sehingga kami mengetahui apa yang diinginkan.

Privasi

Permintaan tidak meminta data pribadi. Alamat yang Anda gunakan untuk mengirim hanya disimpan sebagai digest dengan salt, untuk menerapkan batasan.

Saat ini formulir tidak meminta alamat email: ikuti permintaan melalui id-nya. Jika opsi email balasan ditawarkan kemudian, opsi tersebut bersifat opsional, hanya dikirim saat Anda mencentang kotak, disimpan terpisah dari permintaan, hanya digunakan untuk memberi tahu Anda saat permintaan dirilis atau ditutup, dihapus saat permintaan ditutup atau setelah 365 hari, dan tidak pernah dibagikan. Lihat Privasi.