Two tools built on our data, and what our docs left out

Two developers built tools on our public feeds and customer API. Each one tripped on something our docs never said. What the fields mean, and how to poll them.