Synpath
Buckets

List buckets

The buckets on this server, oldest first.

GET/bucketsself-hosted · access token · view

Self-hosted. Served by synpath serve on your own machine or host, which must be running; the engine and its order types live there. Nothing on this page runs on Synpath's servers.

Only buckets whose every member venue the caller may view are returned.

Query parameters

NameTypeDescription
bookstringOnly this strategy book.
statusstring
default active
active, archived or all.

Response

A page of buckets.

from synpath import Client

client = Client(server="http://127.0.0.1:8000")     # your self-hosted server (synpath serve)
for bucket in await client.fetch_buckets(book="alpha"):
    print(bucket.id, bucket.name, [m.market_id for m in bucket.members])
200
{
  "data": [
    {
      "id": "3f2a9c1e5b7d4e0a8c6f1b2d9e4a7c30",
      "book": "alpha",
      "name": "Fed cut in September",
      "members": [
        {
          "market_id": "kalshi:KXFEDDECISION-26SEP-C25",
          "flip": false
        },
        {
          "market_id": "polymarket:2252244",
          "flip": true
        }
      ],
      "status": "active",
      "created_ms": 1790265600000,
      "updated_ms": 1790265600000
    }
  ],
  "next_cursor": null,
  "count": 1
}