decentralised.art Chain Feed API (0.4.0)

Download OpenAPI specification:

License: MIT

Event-feed discovery endpoints for recently added or updated decentralised.art chain entities. The feed exposes compact metadata for discovery and incremental updates; exact entity endpoints remain the source of truth for full connector, transformation, and condition payloads.

feed

Chain event feed paging and streaming endpoints.

CORS preflight

CORS preflight.

Responses

List feed items

Returns a newest-first page of feed items. Each item is keyed by a stable feed_id and includes compact payload metadata identifying the changed entity. Use /connector/{name}, /transformation/{name}, or /condition/{name} to hydrate full entity details.

query Parameters

limit required	integer [ 1 .. 256 ] Page size. The current server requires this parameter.
before	string History cursor from a previous response `cursor.next_before`.
type	string (FeedEventType) Enum: "connector_added" "transformation_added" "condition_added" Optional event type filter.
include_unfinalized	integer Enum: 0 1 Set to `1` to include observed and safe events. Set to `0` to return only finalized events. When omitted, the current server includes unfinalized events.

Responses

Response samples

200
400

Content type

application/json

{"limit": 1,
"cursor": {"has_more": true,
"next_before": "string"
},
"items": [{"feed_id": "string",
"event_type": "connector_added",
"status": "observed",
"visible": true,
"tx_hash": "string",
"block_number": 0,
"tx_index": 0,
"log_index": 0,
"history_cursor": "string",
"created_at_ms": 0,
"updated_at_ms": 0,
"projector_version": 1,
"payload": {"type": "connector",
"name": "string",
"owner": "string"
}
}
]
}

CORS preflight

CORS preflight.

Responses

Stream feed deltas

Opens a Server-Sent Events stream. The response starts with a bounded replay from since_seq, then emits a stream_meta event describing the replay window, and then tails live feed deltas. Delta event names match their feed event type (connector_added, transformation_added, or condition_added). The JSON in each delta data: frame conforms to schemas/feedStreamDelta.yaml; stream_meta frame data conforms to schemas/feedStreamMeta.yaml. Idle live streams emit keepalive comments.

query Parameters

since_seq	integer <int64> >= 0 Default: 0 Replay stream deltas with `stream_seq` greater than this value.
limit	integer [ 1 .. 2048 ] Default: 200 Maximum number of replay deltas returned before live tailing.

Responses

Response samples

200
400

Content type

text/event-stream

: min_available_seq=1

id: 42
event: connector_added
data: {"stream_seq":42,"event_type":"connector_added","status":"finalized","feed_id":"eth:1:connector_added:demo","history_cursor":"c1710000000000:10:0:eth:1:connector_added:demo","created_at_ms":1710000000000,"payload":{"type":"connector","name":"demo","owner":"0x0000000000000000000000000000000000000000"}}

event: stream_meta
data: {"has_more":false,"last_seq":42,"requested_since_seq":0,"min_available_seq":1,"replay_floor_seq":1,"stale_since_seq":false}