# Introduction

Currents tells you where audience attention is moving inside a category, early
enough to bid on it.

You register a category. We watch it continuously and return a set of **topics** —
each one carrying the direction it is moving, the terms you can bid on, what the
audience sounds like around it, and the videos that prove it. The set is rebuilt
every 24 hours.

## The shape of it

```
POST   /v1/categories            register a category
GET    /v1/categories            list the categories you hold
GET    /v1/categories/{category} read its topics
DELETE /v1/categories/{category} stop tracking it
```

A category you have just registered is `warming`: we have not watched it long
enough to say anything honest yet. That takes about a day, and the response tells
you the moment it will be ready.
Once it is `ready`, every fetch returns the current edition, and `prepared_at` and
`next_update_at` bound the one you are holding.

`pet care` and `fitness clothing` are prepared ahead of time and skip that wait,
so you can read a full response on your first call.

## Every topic gets a direction

`attention_index` and `momentum_index` are both 0-100, and both are speeds rather
than rankings: how fast a topic's videos earn views against comparable YouTube
videos of the same format and age, and how hard that is accelerating. Higher is
faster. The same score means the same thing in every category, and it moves when
the category moves — so you can track one topic across editions and compare topics
across categories you have never bought in before.

`trajectory` is the band `momentum_index` falls in: `surging`, `building`,
`established`, `softening` or `single_channel`. The thresholds are fixed, so a
quiet category reads quiet instead of being flattered, and a category where
everything is moving is allowed to say so.

One guard sits on top of it. **`single_channel`** means the movement is one
channel's output rather than an audience shifting — reported as `building` it would
be lying to you, and you would bid on it.

Start with [the quickstart](/docs/quickstart).
