Skip to main content

jquants_api/models/
td.rs

1use serde::{Deserialize, Serialize};
2
3/// 適時開示一覧(`/td/list`)
4#[derive(Debug, Deserialize, Serialize, Clone)]
5pub struct TdList {
6    /// 開示番号(14桁)
7    #[serde(rename = "DiscNo")]
8    pub disc_no: String,
9    /// 銘柄コード
10    #[serde(rename = "Code")]
11    pub code: String,
12    /// 会社名
13    #[serde(rename = "Name")]
14    pub name: String,
15    /// 開示日 (YYYY-MM-DD)
16    #[serde(rename = "DiscDate")]
17    pub disc_date: String,
18    /// 開示時刻 (HH:MM)
19    #[serde(rename = "DiscTime")]
20    pub disc_time: String,
21    /// 開示タイトル
22    #[serde(rename = "Title")]
23    pub title: String,
24    /// 取扱属性(null=通常/revision=修正/delete=削除)
25    #[serde(rename = "DiscStatus")]
26    pub disc_status: Option<String>,
27    /// 開示履歴番号(1〜99)
28    #[serde(rename = "RevNo")]
29    pub rev_no: String,
30    /// 公開項目コードリスト
31    #[serde(rename = "DiscItems")]
32    pub disc_items: Vec<String>,
33    /// 書類タイプ(g=PDF/s=サマリー/x=XBRL)
34    #[serde(rename = "Docs")]
35    pub docs: Vec<String>,
36}
37
38/// 適時開示一括ダウンロード情報(`/td/bulk`)
39#[derive(Debug, Deserialize, Serialize, Clone)]
40pub struct TdBulk {
41    /// CSVファイルの最終更新日時(ISO 8601形式)
42    #[serde(rename = "lastUpdated")]
43    pub last_updated: String,
44    /// CSVファイルのダウンロードURL
45    pub url: String,
46}
47
48/// 適時開示ファイルの取得先 URL
49#[derive(Debug, Deserialize, Serialize, Clone)]
50pub struct TdFilesInner {
51    /// 開示資料PDFのURL(提供がない場合は `None`)
52    pub pdf: Option<String>,
53    /// サマリーPDFのURL(提供がない場合は `None`)
54    #[serde(rename = "summaryPdf")]
55    pub summary_pdf: Option<String>,
56    /// XBRLファイルのURL(提供がない場合は `None`)
57    pub xbrl: Option<String>,
58}
59
60/// 適時開示ファイル(`/td/files`)
61#[derive(Debug, Deserialize, Serialize, Clone)]
62pub struct TdFiles {
63    /// 開示番号(14桁)
64    #[serde(rename = "discNo")]
65    pub disc_no: String,
66    /// 各書類の取得先 URL。
67    ///
68    /// **書類が1本も無い開示では `null` が返る。** 一覧([`TdList::docs`])が
69    /// 空の開示がこれにあたり、株主総会の招集通知や配当予想の修正など、
70    /// 過去5年で700件ほどある。
71    #[serde(default)]
72    pub files: Option<TdFilesInner>,
73}