NAME
Finance::Robinhood::Account - Single securities trade account
SYNOPSIS
use Finance::Robinhood;
my $rh = Finance::Robinhood->new( token => ... );
my @accounts = $rh->accounts()->{results};
my $account = $accounts[0];
DESCRIPTION
This class represents a single account. Objects are usually created by Finance::Robinhood's accounts( ... )
method rather than directly.
METHODS
This class has several getters and a few methods as follows...
portfolio( )
Gets a quick rundown of the account's financial standing. Results are returned as a hash with the following keys:
adjusted_equity_previous_close Total balance as of previous close +/- after hours trading
equity Total balance
equity_previous_close Total balance as of previous close
excess_margin
extended_hours_equity Total valance including after hours trading
extended_hours_market_value Market value of securities including after hours trading
last_core_equity Total balance
last_core_market_value Market value of securities
market_value Marekt value of securities
positions( ... )
my @positions = $account->positions( );
Returns a paginated list of all securities this account has ever owned. The results
are blessed Finance::Robinhood::Position objects.
my $positions = $account->positions( {cursor => ...} )
Paginated list of positions is continued.
my $positions = $account->positions( {nonzero => 1} )
Returns a paginated list of securities currently owned by this account. This is likely what you want.
account_number( )
my $acct = $account->account_number();
Returns the alphanumeric string Robinhood uses to identify this particular account. Keep this secret!
buying_power( )
Total amount of money you currently have for buying shares of securities.
This is not a total amount of cash as it does not include unsettled funds.
cash( )
Total amount of money on hand. This includes unsettled funds and cash on hand.
cash_available_for_withdrawal( )
Amount of money on hand you may withdrawl to an associated bank account.
cash_held_for_orders( )
Amount of money currently marked for unexecuted buy orders.
deactivated( )
If the account is deactivated for any reason, this will be a true value.
deposit_halted( )
If an attempt to deposit funds to Robinhood fails, I imagine this boolean value would be true.
margin_balances( )
For margin accounts (Robinhood Instant), this is the amount of funds you have access to.
max_ach_early_access_amount( )
Robinhood Instant accounts have early access to a defined amount of money before the actual transfer has cleared.
only_position_closing_trades( )
Boolean value.
sma( )
Simple moving average of funds.
sms_held_for_orders( )
Simple moving average for cash held for outstanding orders.
sweep_enabled( )
Alternative markets?
type( )
Basic Robinhood accounts are cash
accounts while Robinhood Instant accounts would be margin
.
Note: ...I would imagine, not having Instant yet.
uncleared_deposits( )
When a deposit is initited but has not be completed, the amount is added here.
unsettled_funds( )
The amount of money from sell orders which has not settled (see T+3 rule).
updated_at( )
DateTime object marking the last time the account was changed.
withdrawal_halted( )
Boolean value.
LEGAL
This is a simple wrapper around the API used in the official apps. The author provides no investment, legal, or tax advice and is not responsible for any damages incured while using this software. Neither this software nor its author are affiliated with Robinhood Financial LLC in any way.
For Robinhood's terms and disclosures, please see their website at http://robinhood.com/
LICENSE
Copyright (C) Sanko Robinson.
This library is free software; you can redistribute it and/or modify it under the terms found in the Artistic License 2.
Other copyrights, terms, and conditions may apply to data transmitted through this module. Please refer to the LEGAL section.
AUTHOR
Sanko Robinson <sanko@cpan.org>