Feature request: Add better doc strings

[kevinlinxc]

The docstrings for the functions could be more specific to make it easier to understand. For example, they say that start and end date have to be in UTC, but not that they should be datetime.datetime s, instead of epoch seconds or formatted strings.

I think every variable should be annotated with acceptable input types to enable Intellisense/code completion to help end users.