base API finished
updated README somewhat