Skip to main content

Extend a forming series with new bars, from its edge

POST 
/v1/segmentations/extend

Patternode keeps nothing between calls. A forming series is carried by you: each answer returns its edge, a sealed token holding the open right edge of every level. Store it with the segments, and send it back with the next bars. Without an edge, the call starts a new series.

The same edge with the same bars always gives the same answer, so a retry after a timeout is safe: resend the request you sent. Bars must open after the edge's last bar closed (edge_last_close_time); an earlier bar is refused with 409 out_of_order. Extending bar by bar gives the same segments as sending them all as a finished series.

The edge is sealed: encrypted and signed by Patternode, bound to your account, the series name and the profile version. You cannot read or change it, and it is no use to anyone else. What it means for drawing is returned beside it, readable, as right_edge.

Request​

Responses​

The segments the bars closed, the new right edge, and the new edge to store.

Response Headers
    request-id

    Quote it to support.

    ratelimit-policy

    IETF RateLimit-Policy (draft-ietf-httpapi-ratelimit-headers).

    ratelimit

    IETF RateLimit, the current window's remaining allowance.

    server-timing

    Patternode's share of the request's time, W3C Server-Timing.