1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97
//! Coinbase pro client with sync/async + websocket-feed support
//!
//! ## Structure
//!
//! There are two main structures to work with: [`Private`] and [`Public`], which provide interfaces to
//! work with [https://docs.pro.coinbase.com](https://docs.pro.coinbase.com) .
//! The structures should be parametrised with: [`Sync`] or [`ASync`] adapter-type, which blocks
//! future and returns result of its execution for Sync adapter or returns Future for ASync
//! adapter.
//!
//! [`WSFeed`] provides futures::Stream of websocket message for different channels.
//!
//! ## Examples
//!
//! ### Async
//! ```
//! use std::future::Future;
//! use coinbase_pro_rs::{Public, ASync, SANDBOX_URL};
//! use futures::{TryFutureExt};
//!
//! #[tokio::main]
//! async fn main() {
//! let client: Public<ASync> = Public::new_with_keep_alive(SANDBOX_URL, false);
//! // if keep_alive is not disables - tokio::run will hold the connection without exiting the example
//! client.get_time().await
//! .map_err(|_| ())
//! .and_then(|time| {
//! println!("Coinbase.time: {}", time.iso);
//! Ok(())
//! });
//!
//! }
//! ```
//! ### Sync
//! ```
//! use coinbase_pro_rs::{Public, Sync, SANDBOX_URL};
//!
//! fn main() {
//! let client: Public<Sync> = Public::new(SANDBOX_URL);
//! let time = client.get_time().unwrap();
//! println!("Coinbase.time: {}", time.iso);
//!}
//! ```
//! ### Websocket
//! ```
//! use futures::{Future, Stream, StreamExt, TryStreamExt};
//! use coinbase_pro_rs::{WSFeed, CBError, WS_SANDBOX_URL};
//! use coinbase_pro_rs::structs::wsfeed::*;
//!
//! #[tokio::main]
//! async fn main() {
//! let stream = WSFeed::connect(WS_SANDBOX_URL,
//! &["BTC-USD"], &[ChannelType::Heartbeat]).await.unwrap();
//!
//! stream
//! .take(10)
//! .for_each(|msg: Result<Message, CBError>| async {
//! match msg.unwrap() {
//! Message::Heartbeat {sequence, last_trade_id, time, ..} => println!("{}: seq:{} id{}",
//! time, sequence, last_trade_id),
//! Message::Error {message} => println!("Error: {}", message),
//! Message::InternalError(_) => panic!("internal_error"),
//! other => println!("{:?}", other)
//! }
//! }).await;
//! }
//! ```
pub mod adapters;
mod error;
pub mod private;
pub mod public;
pub mod structs;
mod utils;
pub mod wsfeed;
pub use crate::adapters::{ASync, Sync};
pub use crate::error::{CBError, WSError};
pub use crate::private::Private;
pub use crate::public::Public;
pub use crate::wsfeed::WSFeed;
#[cfg(test)]
#[macro_use]
extern crate serial_test;
pub type Result<T> = std::result::Result<T, CBError>;
/// https://api.pro.coinbase.com
pub const MAIN_URL: &str = "https://api.pro.coinbase.com";
/// https://api-public.sandbox.pro.coinbase.com
pub const SANDBOX_URL: &str = "https://api-public.sandbox.pro.coinbase.com";
/// wss://ws-feed.pro.coinbase.com
pub const WS_URL: &str = "wss://ws-feed.pro.coinbase.com";
/// wss://ws-feed-public.sandbox.pro.coinbase.com
pub const WS_SANDBOX_URL: &str = "wss://ws-feed-public.sandbox.pro.coinbase.com";