İçeriğe geç

Veri veya analiz talep etmek

Neye ihtiyacınız olup neye bulamadığınızı söyleyin. İstekler haftalık bir incelemede okunur, benzer verilerle birleştirilir ve kamu kaynaklarının izin verdiği en çok talep edilen veri önce oluşturulur.

Ne zaman talep edilmeli

İhtiyacınız olan bir veri seti, alan, şirket veya analiz eksikse ya da bir cevap yanlış göründüğünde bir talep gönderin. İnsanlar formunukullanır; ajanlar API veya MCP sunucusunu kullanır. Her ikisi de aynı kuyruğa ulaşır, aynı sınırlarla.

Terminaldeki her boş, kapsanmayan ve bilinmeyen şirket eyaleti, formu dolduran bir Talep Bağlantısıyla sona erer. Komut paleti de Request veri veya analiz listeliyor.

Türleri

NazikOnu şu şekilde kullanın
datasetEksik olan bir veri seti
fieldTek satır öğe veya özellik
analysisElle yapılması gereken bir hesaplama
coverageKapsamadığımız bir şirket, borsa veya ülke
bugYanlış ya da bozuk bir cevap
otherBaşka bir şey var mı?

Formu kullanın

Talep Veri veya analiz formu, ne tür olduğunu, neye ihtiyacınız olduğunuzu, neden (isteğe bağlı) ve bir şirketi (isteğe bağlı) sorar. Metne kişisel veri eklemeyin.

Hemen bir talep kimliği alırsınız. Durumu daha sonra kontrol etmek için onu saklayın.

Bir tane gönder API

POST /v1/request-data kind ve wantalır, isteğe bağlı olarak why, company ve endpoint_or_toolalır. Anahtara ihtiyaç duymuyor ve asla şarj edilmiyor.

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

Cevap 201, istek kimliği, katıldığı talep öğesi, durumu ve şimdiye kadar kaç kişi sorulduğu ile birlikte:

{
  "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": { ... }
}

Her UTC günde adres başına 10 talaba kadar istek, toplamda 500 tane. Her iki sınırı da geçtiğinde cevap 429 ile Retry-After olur (bkz. rate_limited). GET /v1/request-data bedeni tanımlar.

Bir ajandan gönder

Bir ajan, yukarıdaki POST çağrısıyla bir talep gönderir. MCP sunucuda request_status aracı kimliğine göre birini arar API 'den alınmayan cevaplar request_databir tür çözüm taşır, yani bir ajan asla takılmaz.

https://mcp.financial.md/mcp

Durumunu takip edin

Benzer talepler, tür, şirket ve konsepte göre belirlenmiş tek bir talep öğesine birleşir; tekrar edilen bir talep bir oy eklenir. durum sayfasında bir veya GET /v1/request-data/{id}ile bir talep bulabilirsiniz:

curl "https://api.financial.md/v1/request-data/0b8f6a52-6f0e-4a8e-9a43-3c0f6b2d1e11"
DurumAnlamı
newAlındı, henüz inceleme yapılmadı
triagedİncelendi ve benzer taleplerle birleştirildi
plannedİnşa etmeyi düşünüyoruz
doneYapıldı; served_by ona hizmet eden rota veya aracı adlandırıyor
wontfixİnşamayacağız; kamu notunda nedenini belirtiyor

İstendi ve gönderildi

Talep Edildi ve Gönderildi sayfası, bizim tarafımızdaki bir kişinin incelediği ve başlıklandırdığı öğeleri, sayıları ve sonuçlarıyla birlikte listeler. Bir ürün asla otomatik olarak listelenmez. Sadece agregaları gösterir: gönderici yok, gönderilen metin yok. Aynı veri JSON akışı olarak da geçerlidir:

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

değişiklik günlüğü panoya bağlantı veriyor ve her gönderilen ürün ona hizmet eden şeyin adını yazıyor.

Ne inşa edebiliriz

Açık kamu kaynaklarından ve kendi türetilmiş analizimizden inşa ediyoruz:

  • SEC EDGAR dosyaları ve veri setleri (beyanlar, sahiplik, etkinlikler, fonlar)
  • FRED ve diğer kamu istatistikleri
  • Zaten sunduğumuz veriler üzerinde hesaplamalar (oranlar, ekranlar, karşılaştırmalar)

Lisans gerektiren veya yeniden kullanımı yasaklayan veriler, örneğin uzlaşma tahminleri, analist derecelendirmeleri veya gerçek zamanlı borsa akışları, wontfix işaret eden bir notla işaretlenir GET /v1/coverage. Daha sonraki talepler yine oy olarak sayılır, böylece ne istendiğini biliyoruz.

Gizlilik

Bir talep kişisel veri talep etmez. Gönderdiğiniz adres sadece tuzlu bir özet olarak saklanır, sınırlar uygulanır.

Form şu anda e-posta adresi istemiyor: isteği kimliğine göre takip et. Yanıt e-postası daha sonra sunulursa, isteğe bağlıdır, sadece kutuyu işaretlediğinizde gönderilir, istekten ayrı tutulur, sadece talebin gönderildiğinde veya kapandığında size haber vermek için kullanılır, istek kapandığında veya 365 gün sonra silinir ve hiç paylaşılmaz. Bkz. Gizlilik.