first version of FXInstrument convenience functions