finished draft of trading methods API