NAME
Finance::Bank::Schwab - Check your account balances at Charles Schwab
VERSION
version 2.03
SYNOPSIS
use Finance::Bank::Schwab;
my @accounts = Finance::Bank::Schwab->check_balance(
username => "xxxxxxxxxxxx",
password => "12345",
get_position => 1,
);
for ( @accounts ) {
printf "%20s : %8s / %8s : USD %9.2f USD %9.2f\n",
$_->name, $_->sort_code, $_->account_no, $_->cash, $_->balance;
for my $position ( @{ $_->positions } ) {
printf "# \t%-10s %-10s %10s Shares \@ \$%-15s\n",
$position->type,
$position->symbol,
$position->quantity,
$position->price;
}
print "\n";
}
DESCRIPTION
This module provides a rudimentary interface to the Charles Schwab site.
You will need either "Crypt::SSLeay" or "IO::Socket::SSL" installed for
HTTPS support to work. "WWW::Mechanize" is required. If you encounter
odd errors, install "Net::SSLeay" and it may resolve itself.
CLASS METHODS
check_balance()
check_balance( usename => $u, password => $p, get_positions => 1 )
Return an array of account objects, one for each of your bank accounts.
If the "get_positions" flag is true then account positions (share
counts, prices, etc) will be retrieved as well.
OBJECT METHODS
$ac->name
$ac->sort_code
$ac->account_no
Return the account name, sort code and the account number. The sort code
is just the name in this case, but it has been included for consistency
with other Finance::Bank::* modules.
$ac->balance
Return the account balance as a signed floating point value.
$ac->cash
Return the cash balance as a signed floating point value. This is useful
if the account has margin borrowing as the balance alone doesn't do
justice.
$ac->positions
Returns a reference to an array of
Finance::Bank::Schwab::Account::Positions objects. Each provides the
following method:
$position->symbol (String)
$position->quantity (Signed Float)
$position->price (Signed Float)
$position->type (Stock/Bond/Cash/Unknown)
WARNING
This warning is verbatim from Simon Cozens' "Finance::Bank::LloydsTSB",
and certainly applies to this module as well.
This is code for online banking, and that means your money, and that
means BE CAREFUL. You are encouraged, nay, expected, to audit the source
of this module yourself to reassure yourself that I am not doing
anything untoward with your banking data. This software is useful to me,
but is provided under NO GUARANTEE, explicit or implied.
THANKS
Simon Cozens for "Finance::Bank::LloydsTSB". The interface to this
module, some code and the pod were all taken from Simon's module.
Thanks to Ryan Clark <ryan.clark9@gmail.com> for contributing the
initial implementation of the share count/price/etc retrieval routines.
AUTHOR
Mark Grimes <mgrimes@cpan.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2013 by Mark Grimes <mgrimes@cpan.org>.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.