Is there an API for retrieving the current balance of my PayPal account?

Yes, this API is called the GetBalance API. You can find details on this call and its parameters here: