List stacks

List your stacks with cursor pagination.

GET /manager/stacks

List your stacks

cURL

curl --request GET \
  --url https://api-staging.mystacks.ai/manager/stacks \
  --header 'Authorization: Bearer <token>'

200

{
  "items": [
    {
      "id": "bf4bc5e9-0d9e-454c-bc1c-30abc120b074",
      "current_revision_id": "e137435f-83ce-4b3c-86ae-75d6462487b6",
      "name": "Example stack",
      "allocation": [
        {
          "token_address": "0x117cc2133c37b721f49de2a7a74833232b3b4c0c",
          "weight_bps": 6000
        },
        {
          "token_address": "0xd0601ce157db5bdc3162bbac2a2c8af5320d9eec",
          "weight_bps": 4000
        }
      ],
      "schedule": {
        "preset": "daily"
      }
    }
  ],
  "next_cursor": null
}

Returns only stacks owned by the manager identified by your API key. Each item contains its current complete configuration.

Pagination

Stacks are ordered by creation time descending, then stack ID descending. If next_cursor is a string, pass it unchanged as the next request’s cursor. URL-encode it rather than building the query by hand. Stop when next_cursor is null.

Do not decode or construct cursors. Each page reads current configurations. Pagination does not freeze stack contents across requests.

Unknown query parameters and repeated parameters return 400 invalid_request. Empty or malformed cursors also return 400. The limit accepts decimal digits within the allowed range. Fractions, signed values, and exponential notation are invalid.

See shared errors for authentication and service failures.

Authorizations

Authorization · string · header · required

Enter the API key supplied by MyStacks. The playground adds the Authorization: Bearer prefix for you.

Headers

X-Request-Id · string

Optional request trace ID. A nonempty value is echoed in the response. Missing or empty values cause a UUID to be generated.

Query Parameters

cursor · string

Opaque next_cursor from a previous response. Omit it for the first page. Empty or malformed values are invalid.

Minimum string length: 1

limit · integer · default: 25

Page size. Send an integer from 1 through 100 using decimal digits only.

Required range: 1 <= x <= 100

Response

200

application/json

One page of manager-owned stacks.

items · object[] · required

Only stacks owned by the authenticated manager. Ordered by creation time descending, then stack ID descending.

Show child attributes

next_cursor · string | null · required

Opaque cursor to pass unchanged to the next list request. Null marks the last page.

Minimum string length: 1

Example:

null