it'd be good to mention that this api is nonblocking aka will use about 100% of your cpu.