Get a governance announcement

/api/v1/announcements/{id}GET

Single announcement by id.

Authorization

bearerAuth *Bearer <token>

Session token from the app, or an API key (the ak_ prefix), sent as a Bearer token or an ?api_key= query parameter.. Token in: header

Response

200 · The announcement.

id *string

Stable public id.

notice_date *string (date-time)

When the change was announced.

effective_date?string (date-time)

When the change takes effect. Omitted when it is the notice date.

title *string

body?string

Plain-text narrative. Omitted when the notice has no body.

affected_indices *string[]

Index tickers this notice applies to. One change that fans across several indices is one row.

added_markets *string[]

Market ids added to the basket. Empty for non-rebalances.

removed_markets *string[]

Market ids removed from the basket.

provenance *object

Source back-pointer object.

401 · Unauthorized

error?string

Human-readable reason the request was not authenticated or authorized, for example a missing or malformed Authorization header, an invalid token, or a token lacking the required scope. This is free text whose wording can change, so branch on status (or the HTTP status code) instead of on this string.

status?integer

The HTTP status code repeated in the body.

403 · The organization has no paid plan, so the realtime read scopes are refused. Distinct from a 429, which means a plan's budget ran out: nothing here resets on a timer, and the request succeeds only once the organization holds a plan.

error *string

Human-readable reason the request was refused.

status *integer

HTTP status code, repeated in the body.

upgrade_url?string (uri)

Page listing the plans and their request allowances, for buying access. Absent when no plan is available for purchase.

404 · Announcement not found.

error?string

Stable, machine-readable code identifying the failure; branch on this rather than on message. One of bad_request, unauthorized, forbidden, not_found, conflict, service_unavailable, upstream_error, service_error, or internal_error.

message?string

Human-readable explanation, safe to show to a user. For client errors it names the specific problem; for server-side failures it is a generic notice and the underlying detail is deliberately withheld.

429 · The organization's minute or UTC-day request budget is exhausted, or the organization has reached its cap on requests running at the same time (`limit: "concurrency"`). Wait `Retry-After` seconds before retrying; for a concurrency 429, reduce parallelism.

error *"rate_limited"

Always rate_limited. Branch on this to detect a throttled request.

limit *"rpm" | "daily" | "concurrency"

Which limit was hit: rpm for the per-minute cap, daily for the daily one, or concurrency for the cap on requests running at the same time.

message *string

Human-readable explanation naming the limit that was exceeded.

upgrade_url?string (uri)

Page listing the plans and their request allowances, for buying a larger budget. Absent when no plan is available for purchase.

Request example

curl -X GET "https://api.adjacent.markets/api/v1/announcements/<id>" \
  -H "Authorization: Bearer <token>"

Response example

{
  "error": "Insufficient scope: a Pro or Premium API plan is required",
  "status": 403,
  "upgrade_url": "https://adjacent.markets/subscribe"
}