udpate readme with speculative api