finished basic Speare API functions [not testing yet]