Skip to main content

FinFeedDataLoader

Struct FinFeedDataLoader 

Source
pub struct FinFeedDataLoader { /* private fields */ }
Expand description

Fetches historical Nautilus data using retained outcome definitions.

Construction sends no requests and resolves credentials on the first network operation. Load or register definitions before requesting market data. Requests share one HTTP client, including its attempt allowance. Definition refreshes are explicit; each history request uses a snapshot of its registered definition and returns no partial result on failure.

Implementations§

Source§

impl FinFeedDataLoader

Source

pub fn new(api_key: Option<SecretString>) -> Self

Creates a loader with an empty instrument registry and lazy HTTP transport.

Source

pub fn with_http_config( api_key: Option<SecretString>, http_config: FinFeedHttpConfig, ) -> Self

Creates a loader with explicit HTTP controls, without resolving credentials or sending requests.

Source

pub fn add_instrument(&self, instrument: BinaryOption) -> Result<()>

Registers an outcome definition, replacing the same ID after validation.

§Errors

Returns an error if the ID is not a FinFeed outcome or an outcome token has another owner.

Source

pub fn instrument(&self, instrument_id: InstrumentId) -> Result<BinaryOption>

Returns a retained definition.

§Errors

Returns an error if the definition has not been loaded or registered.

Source

pub async fn request_instrument( &self, instrument_id: InstrumentId, ) -> Result<BinaryOption>

Fetches and retains a fresh outcome definition.

§Errors

Returns an error if retrieval, identity checks, or definition validation fails.

Source

pub async fn request_instruments( &self, instruments: &[FinFeedInstrumentSelection], ) -> Result<Vec<BinaryOption>>

Fetches the supplied outcome selections and retains them atomically.

§Errors

Returns an error if selections, retrieval, or any definition fails validation. Failures preserve all previously registered definitions.

Source

pub async fn request_book_deltas( &self, instrument_id: InstrumentId, start: UnixNanos, end: UnixNanos, limit: Option<NonZeroUsize>, ) -> Result<Vec<OrderBookDelta>>

Retrieves historical book deltas using the retained definition.

Bounds are inclusive on the adapter’s ordering clock. The local limit preserves complete book batches. A missing snapshot seed or ambiguous continuation rejects book history.

§Errors

Returns an error if metadata is missing, bounds are invalid, or retrieval or conversion fails.

Source

pub async fn request_quotes( &self, instrument_id: InstrumentId, start: UnixNanos, end: UnixNanos, limit: Option<NonZeroUsize>, ) -> Result<Vec<QuoteTick>>

Retrieves historical quotes using the retained definition.

Bounds are inclusive on the adapter’s ordering clock.

§Errors

Returns an error if metadata is missing, bounds are invalid, or retrieval or conversion fails.

Source

pub async fn request_trades( &self, instrument_id: InstrumentId, start: UnixNanos, end: UnixNanos, limit: Option<NonZeroUsize>, ) -> Result<Vec<TradeTick>>

Retrieves historical trades using the retained definition.

Bounds are inclusive on the adapter’s ordering clock.

§Errors

Returns an error if metadata is missing, bounds are invalid, or retrieval or conversion fails.

Source

pub async fn request_bars( &self, bar_type: BarType, start: UnixNanos, end: UnixNanos, limit: Option<NonZeroUsize>, ) -> Result<Vec<Bar>>

Retrieves historical bars using the retained definition.

Bounds are inclusive on the adapter’s ordering clock.

§Errors

Returns an error if metadata is missing, bounds are invalid, or retrieval or conversion fails.

Trait Implementations§

Source§

impl Debug for FinFeedDataLoader

Source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
§

impl<T> PolicyExt for T
where T: ?Sized,

§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] only if self and other return Action::Follow. Read more
§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] if either self or other returns Action::Follow. Read more
§

impl<T> PolicyExt for T
where T: ?Sized,

§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] only if self and other return Action::Follow. Read more
§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] if either self or other returns Action::Follow. Read more
§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<T> Ungil for T
where T: Send,

§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more