6 releases (3 breaking)

0.4.0 Aug 31, 2022
0.3.0 May 6, 2022
0.2.1 Sep 20, 2021
0.1.1 Sep 7, 2021

#153 in Finance

MIT license

69KB
1.5K SLoC

rplaid

crates.io Released API docs MIT licensed GHA Build Status

rplaid is an async client for the Plaid API. With minimal features, the client is meant to be extensible and lightweight. Additional features can be enabled to improve ergonomics of the API at the cost of additional dependencies.

The goal is to provide expressive bindings that provide sensible defaults where possible for ease of use.

See official API docs for more information about endpoints or specific products.

These are not official Plaid bindings.

use rplaid::client::{Builder, Credentials};
use rplaid::model::*;

#[tokio::main]
async fn main() {
    let client = Builder::new()
        .with_credentials(Credentials {
            client_id: std::env::var("PLAID_CLIENT_ID").unwrap(),
            secret: std::env::var("PLAID_SECRET").unwrap(),
        })
        .build();
    let institutions = client
        .get_institutions(&InstitutionsGetRequest {
            count: 10,
            offset: 0,
            country_codes: &["US"],
            options: None,
        })
        .await
        .unwrap();

    println!("{:?}", institutions);
}

Glossary

  • Item - A Item represents a connection to a single financial instution. Typically links are associated with a pair of credentials and an access_token. Items are associated to one or more accounts.

  • Link - Link is a client-side component that Plaid provides to link to accounts. See https://plaid.com/docs/link/#introduction-to-link for more information.

  • Account - An account is a financial account that is linked to an Item. An item, or financial institution, may have multiple accounts for a single user (e.g. a checking account and a credit account).

  • Product - Entities with services offered by Plaid, see https://plaid.com/docs/api/products/ for more information.

Features

  • Idiomatic futures generator for easily reading multiple pages of transactions.
  • Extensible HttpClient interfaces supports multiple HTTP clients with minimal effort (surf, H1, and reqwest). The trait can also be implemented to have full control over the HTTP client used.
  • Rust types, including variant types, for most API return types.

Limitations

Some endpoints are production specific or beta products and are not yet supported by the client.

For a breakdown of endpoint support visit: https://docs.google.com/spreadsheets/d/1xqUXdfllo37Rx5MVrQODbVqNQvuktiCVL5Uh8y9mYYw

License

MIT

Dependencies

~9–16MB
~191K SLoC