improved validation logic around amounts and timestamps. API doc mod