add phpdoc; refactor currency pair to be exchange rate