API
For trading desks, buying agents and platforms
Bring Currents intelligence into your systems.
Register a category and read its topics: keywords, IAB categories, momentum, suitability and evidence. REST, MCP and AdCP.
$ curl "$CURRENTS_API/v1/categories/pet%20care" \
-H "Authorization: Bearer $CURRENTS_API_KEY"
{
"category": "pet care",
"status": "ready",
"next_update_at": "2026-09-23T06:00:00Z",
"highlights": {
"big": ["cat-grooming", "rescue-and-adoption"],
"fast_moving": ["aquarium-keeping", "rescue-and-adoption"],
"uncontested": ["pet-bird-care"]
},
"topics": [
{
"topic": "aquarium-keeping",
"terms": ["aquarium", "betta", "aquascaping", "planted tank"],
"momentum_index": 92,
"trajectory": "breakout"
}
]
}- 1
- key, every answer
- 4
- calls cover the whole API
- 24h
- every topic set rebuilt
- 3.1
- IAB Content Taxonomy version
One key, every callRegister a category.
Register a category.
Read its topics.
A category is a plain phrase. Responses are shortened; every field is in the docs.
Get a keyread-topics.sh
Built for systems that act on it.
Trading systems, internal tools and buying agents consume the same endpoints.
- MCP server
- The same intelligence in planning tools and agent stacks.
- AdCP
- Currents runs an AdCP signal agent. Your buying agents discover and activate Currents signals directly.
- Published definitions
- Every metric is defined, so an agent can quote it and a planner can defend it.
Start building on the signal.
Book a demo. You leave with a key, the docs, and your scope set.