Struct SymbolCache 

pub struct SymbolCache { /* private fields */ }

Symbol → conid cache.

Resolving a ticker to IBKR’s numeric conid is a search call, and it’s stable across days — most bots do it once per ticker per session. Wrap your Client with a SymbolCache to memoise lookups.

The cache is deliberately simple: a Mutex<HashMap>. It’s built for the low-volume rebalance-bot case (dozens of tickers, infrequent refreshes) rather than high-volume quote streaming.

Example

let client = bezant::Client::new("https://localhost:5000/v1/api")?;
let cache = bezant::SymbolCache::new(client);
let aapl = cache.conid_for("AAPL").await?;
let msft = cache.conid_for("MSFT").await?;
// further calls for AAPL/MSFT hit the in-memory cache.

Implementations

impl SymbolCache

pub fn new(client: Client) -> Self

Wrap a Client with an empty cache.

pub async fn conid_for(&self, symbol: &str) -> Result<i64>

Return the cached conid for symbol, looking it up on first miss.

Only STK-type matches are cached. If you need options / bonds / futures, call Client::api directly. Both hits and misses are memoised — if a symbol turns out to be invalid, subsequent calls return Error::SymbolNotFound without touching the network.

Errors

Error::SymbolNotFound if the symbol doesn’t resolve to any contract, Error::BadConid if the upstream returned a contract whose conid wasn’t a parseable integer, plus any transport / decode errors.

pub fn forget(&self, symbol: &str)

Drop a single entry — useful after IBKR restructures a listing.

pub fn clear(&self)

Clear the whole cache.

pub fn client(&self) -> &Client

Borrow the inner Client — useful when callers want both the cache and direct API access from the same instance.

Trait Implementations

impl Debug for SymbolCache

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.