type Params<'a> = Vec<(&'static str, &'a str)>;
fn push<'a>(params: &mut Params<'a>, key: &'static str, value: &'a Option<String>) {
if let Some(v) = value {
params.push((key, v.as_str()));
}
}
#[derive(Debug, Clone, Default)]
pub struct CodeDateQuery {
pub code: Option<String>,
pub date: Option<String>,
pub from: Option<String>,
pub to: Option<String>,
}
impl CodeDateQuery {
pub fn code(code: impl Into<String>) -> Self {
Self {
code: Some(code.into()),
..Self::default()
}
}
pub(crate) fn params(&self) -> Params<'_> {
let mut p = Vec::new();
push(&mut p, "code", &self.code);
push(&mut p, "date", &self.date);
push(&mut p, "from", &self.from);
push(&mut p, "to", &self.to);
p
}
}
#[derive(Debug, Clone, Default)]
pub struct MasterQuery {
pub code: Option<String>,
pub date: Option<String>,
}
impl MasterQuery {
pub(crate) fn params(&self) -> Params<'_> {
let mut p = Vec::new();
push(&mut p, "code", &self.code);
push(&mut p, "date", &self.date);
p
}
}
#[derive(Debug, Clone, Default)]
pub struct InvestorTypesQuery {
pub section: Option<String>,
pub from: Option<String>,
pub to: Option<String>,
}
impl InvestorTypesQuery {
pub(crate) fn params(&self) -> Params<'_> {
let mut p = Vec::new();
push(&mut p, "section", &self.section);
push(&mut p, "from", &self.from);
push(&mut p, "to", &self.to);
p
}
}
#[derive(Debug, Clone, Default)]
pub struct CalendarQuery {
pub holiday_division: Option<String>,
pub from: Option<String>,
pub to: Option<String>,
}
impl CalendarQuery {
pub(crate) fn params(&self) -> Params<'_> {
let mut p = Vec::new();
push(&mut p, "holidayDivision", &self.holiday_division);
push(&mut p, "from", &self.from);
push(&mut p, "to", &self.to);
p
}
}
#[derive(Debug, Clone, Default)]
pub struct MarginInterestQuery {
pub code: Option<String>,
pub date: Option<String>,
pub from: Option<String>,
pub to: Option<String>,
pub published_date: Option<String>,
}
impl MarginInterestQuery {
pub(crate) fn params(&self) -> Params<'_> {
let mut p = Vec::new();
push(&mut p, "code", &self.code);
push(&mut p, "date", &self.date);
push(&mut p, "from", &self.from);
push(&mut p, "to", &self.to);
push(&mut p, "published_date", &self.published_date);
p
}
}
#[derive(Debug, Clone, Default)]
pub struct ShortRatioQuery {
pub s33: Option<String>,
pub date: Option<String>,
pub from: Option<String>,
pub to: Option<String>,
}
impl ShortRatioQuery {
pub(crate) fn params(&self) -> Params<'_> {
let mut p = Vec::new();
push(&mut p, "s33", &self.s33);
push(&mut p, "date", &self.date);
push(&mut p, "from", &self.from);
push(&mut p, "to", &self.to);
p
}
}
#[derive(Debug, Clone, Default)]
pub struct ShortSaleReportQuery {
pub code: Option<String>,
pub disc_date: Option<String>,
pub disc_date_from: Option<String>,
pub disc_date_to: Option<String>,
pub calc_date: Option<String>,
}
impl ShortSaleReportQuery {
pub(crate) fn params(&self) -> Params<'_> {
let mut p = Vec::new();
push(&mut p, "code", &self.code);
push(&mut p, "disc_date", &self.disc_date);
push(&mut p, "disc_date_from", &self.disc_date_from);
push(&mut p, "disc_date_to", &self.disc_date_to);
push(&mut p, "calc_date", &self.calc_date);
p
}
}
#[derive(Debug, Clone, Default)]
pub struct RangeQuery {
pub from: Option<String>,
pub to: Option<String>,
}
impl RangeQuery {
pub(crate) fn params(&self) -> Params<'_> {
let mut p = Vec::new();
push(&mut p, "from", &self.from);
push(&mut p, "to", &self.to);
p
}
}
#[derive(Debug, Clone, Default)]
pub struct FuturesBarsQuery {
pub category: Option<String>,
pub date: Option<String>,
pub contract_flag: Option<String>,
}
impl FuturesBarsQuery {
pub(crate) fn params(&self) -> Params<'_> {
let mut p = Vec::new();
push(&mut p, "category", &self.category);
push(&mut p, "date", &self.date);
push(&mut p, "contractFlag", &self.contract_flag);
p
}
}
#[derive(Debug, Clone, Default)]
pub struct OptionsBarsQuery {
pub category: Option<String>,
pub code: Option<String>,
pub date: Option<String>,
pub contract_flag: Option<String>,
}
impl OptionsBarsQuery {
pub(crate) fn params(&self) -> Params<'_> {
let mut p = Vec::new();
push(&mut p, "category", &self.category);
push(&mut p, "code", &self.code);
push(&mut p, "date", &self.date);
push(&mut p, "contractFlag", &self.contract_flag);
p
}
}
#[derive(Debug, Clone, Default)]
pub struct FinsQuery {
pub code: Option<String>,
pub date: Option<String>,
pub cursor: Option<String>,
}
impl FinsQuery {
pub(crate) fn params(&self) -> Params<'_> {
let mut p = Vec::new();
push(&mut p, "code", &self.code);
push(&mut p, "date", &self.date);
push(&mut p, "cursor", &self.cursor);
p
}
}
#[derive(Debug, Clone, Default)]
pub struct EarningsDateQuery {
pub code: Option<String>,
pub date: Option<String>,
pub scheduled_date: Option<String>,
}
impl EarningsDateQuery {
pub(crate) fn params(&self) -> Params<'_> {
let mut p = Vec::new();
push(&mut p, "code", &self.code);
push(&mut p, "date", &self.date);
push(&mut p, "scheduled_date", &self.scheduled_date);
p
}
}
#[derive(Debug, Clone, Default)]
pub struct EdinetQuery {
pub edinet_code: Option<String>,
pub code: Option<String>,
pub date: Option<String>,
}
impl EdinetQuery {
pub(crate) fn params(&self) -> Params<'_> {
let mut p = Vec::new();
push(&mut p, "edinet_code", &self.edinet_code);
push(&mut p, "code", &self.code);
push(&mut p, "date", &self.date);
p
}
}
#[derive(Debug, Clone, Default)]
pub struct TdListQuery {
pub date: Option<String>,
pub code: Option<String>,
pub from: Option<String>,
pub to: Option<String>,
pub disc_items: Option<String>,
pub cursor: Option<String>,
}
impl TdListQuery {
pub(crate) fn params(&self) -> Params<'_> {
let mut p = Vec::new();
push(&mut p, "date", &self.date);
push(&mut p, "code", &self.code);
push(&mut p, "from", &self.from);
push(&mut p, "to", &self.to);
push(&mut p, "discItems", &self.disc_items);
push(&mut p, "cursor", &self.cursor);
p
}
}
#[derive(Debug, Clone, Default)]
pub struct BulkListQuery {
pub endpoint: Option<String>,
pub date: Option<String>,
pub from: Option<String>,
pub to: Option<String>,
}
impl BulkListQuery {
pub(crate) fn params(&self) -> (Option<String>, Params<'_>) {
let endpoint = normalize_endpoint(&self.endpoint);
let mut p = Vec::new();
push(&mut p, "date", &self.date);
push(&mut p, "from", &self.from);
push(&mut p, "to", &self.to);
(endpoint, p)
}
}
#[derive(Debug, Clone, Default)]
pub struct BulkGetQuery {
pub key: Option<String>,
pub endpoint: Option<String>,
pub date: Option<String>,
}
impl BulkGetQuery {
pub(crate) fn params(&self) -> (Option<String>, Params<'_>) {
let endpoint = normalize_endpoint(&self.endpoint);
let mut p = Vec::new();
push(&mut p, "key", &self.key);
push(&mut p, "date", &self.date);
(endpoint, p)
}
}
fn normalize_endpoint(endpoint: &Option<String>) -> Option<String> {
endpoint.as_ref().map(|e| {
if e.starts_with('/') {
e.clone()
} else {
format!("/{e}")
}
})
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn code_date_query_skips_none() {
let q = CodeDateQuery {
code: Some("86970".into()),
from: Some("2026-01-01".into()),
..Default::default()
};
assert_eq!(q.params(), vec![("code", "86970"), ("from", "2026-01-01")]);
}
#[test]
fn code_date_query_empty() {
assert!(CodeDateQuery::default().params().is_empty());
}
#[test]
fn code_shortcut() {
let q = CodeDateQuery::code("7203");
assert_eq!(q.params(), vec![("code", "7203")]);
}
#[test]
fn margin_interest_query_sends_published_date() {
let q = MarginInterestQuery {
code: Some("86970".into()),
published_date: Some("2026-09-28".into()),
..Default::default()
};
assert_eq!(
q.params(),
vec![("code", "86970"), ("published_date", "2026-09-28")]
);
}
#[test]
fn calendar_query_uses_camel_case_param() {
let q = CalendarQuery {
holiday_division: Some("1".into()),
..Default::default()
};
assert_eq!(q.params(), vec![("holidayDivision", "1")]);
}
#[test]
fn bulk_query_normalizes_endpoint() {
let (endpoint, _) = BulkListQuery {
endpoint: Some("equities/bars/daily".into()),
..Default::default()
}
.params();
assert_eq!(endpoint.as_deref(), Some("/equities/bars/daily"));
let (endpoint, _) = BulkGetQuery {
endpoint: Some("/equities/bars/daily".into()),
..Default::default()
}
.params();
assert_eq!(endpoint.as_deref(), Some("/equities/bars/daily"));
}
}