API v1 spec

This is still a work-in-progress, but any feedback is more than welcome.
Is a token really a point in time? So I can retrieve e.g. the set of units at any arbitrary point in fleet's history?