rhood-core 0.2.0

Async Rust client library for the Robinhood trading API
Documentation 
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

use crate::Result;
use crate::api::paths;
use crate::client::RobinhoodClient;
use crate::models::transfer::Transfer;

impl RobinhoodClient {
    /// Fetches all unified transfers (ACH, wire, debit card).
    ///
    /// Uses the Bonfire API to retrieve a consolidated view of all transfer
    /// types in a single request.
    ///
    /// # Errors
    ///
    /// Returns an error if the HTTP request fails or the response cannot be
    /// deserialized.
    pub async fn get_transfers(&self) -> Result<Vec<Transfer>> {
        self.get_paginated(&self.bonfire_url(paths::UNIFIED_TRANSFERS), &[])
            .await
    }
}

#[cfg(test)]
mod tests {
    use crate::models::transfer::Transfer;

    #[test]
    fn transfer_deserializes_full() {
        let json = r#"{
            "id": "xfer-001",
            "transfer_type": "originated_ach",
            "amount": "500.00",
            "currency": "USD",
            "direction": "pull",
            "state": "completed",
            "created_at": "2026-03-01T10:00:00Z",
            "updated_at": "2026-03-02T10:00:00Z",
            "net_amount": "500.00",
            "service_fee": "0.00",
            "originating_account_id": "bank-001",
            "originating_account_type": "ach",
            "receiving_account_id": "rh-001",
            "receiving_account_type": "brokerage",
            "is_visible_in_history": true,
            "details": {"ach_relationship_id": "rel-001"}
        }"#;
        let xfer: Transfer = serde_json::from_str(json).unwrap();
        assert_eq!(xfer.id.as_deref(), Some("xfer-001"));
        assert_eq!(xfer.transfer_type.as_deref(), Some("originated_ach"));
        assert_eq!(xfer.direction.as_deref(), Some("pull"));
        assert!(xfer.details.is_some());
    }

    #[test]
    fn transfer_handles_missing_fields() {
        let json = r#"{"id": "xfer-002", "state": "pending"}"#;
        let xfer: Transfer = serde_json::from_str(json).unwrap();
        assert_eq!(xfer.id.as_deref(), Some("xfer-002"));
        assert!(xfer.details.is_none());
        assert!(xfer.transfer_type.is_none());
    }
}