Buckets
Get a bucket
One bucket and its members.
GET/buckets/{bucket_id}self-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.
Path parameters
| Name | Type | Description |
|---|---|---|
bucket_id | string | The bucket's id, or its market id bucket:<id>. |
Response
The bucket. 404 if there is none; 403 if the caller may not view every member venue.
from synpath import Client
client = Client(server="http://127.0.0.1:8000") # your self-hosted server (synpath serve)
bucket = await client.fetch_bucket("bucket:<bucket_id>")200
{
"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
}