POST
cURL
Roles: operator. Four eyes: it runs once an approver other than the maker approves it.

Authorizations

Authorization
string
header
required

A JWT from the deployment's identity provider, whose roles claim names the caller's roles and whose holder claim names an investor's holder.

Headers

Idempotency-Key
string

Names this write, so a retry answers the same operation; absent, the write is keyed on its body.

X-Signature-Key
string

A signed request's key id, as venue.api.signing.clients configures it for the bearer's subject.

X-Signature-Timestamp
string

Seconds since the epoch, within venue.api.signing.window of the engine's clock, 5 minutes by default.

Pattern: ^[0-9]+$
X-Signature-Nonce
string

At least 16 random bytes in base64url, never reused within twice the window.

Required string length: 22 - 128
Pattern: ^[A-Za-z0-9_-]+={0,2}$
X-Signature
string

The base64 HMAC-SHA256, under the key's secret, of the method, the path and query, the timestamp, the nonce and the body's SHA-256.

X-Request-Id
string

Your id for this request, 1 to 128 printable characters, repeated in the answer; absent, the engine makes one.

Maximum string length: 128
Pattern: ^[\x21-\x7E]+$
traceparent
string

A W3C trace context, which the engine joins and passes on.

Pattern: ^[0-9a-f]{2}-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$

Body

application/json

The standing settlement to open.

kind
enum<string>
required

What the standing settlement settles.

Available options:
sweep,
liquidity-pool
instrumentId
string
required

The fund: a base instrument with a live consent to a primary market paid on the ledger.

amount
number
required

The payment asset committed: what a sweep asks its investor to commit, or what the treasury commits to a pool.

minimum
number
required

The least one iteration pays.

limit
number
required

The most the iterations of one window pay together.

until
string
required

Until when its allocations are committed, an instant; their settlement deadline.

holderId
string | null

A sweep's investor; absent for a liquidity pool.

window
string | null

The window limit counts over, an ISO-8601 duration; absent, a day.

standingSettlementId
string | null

The standing settlement's id; absent, st- and 20 random hex digits.

custodians
string[]

The parties operating the investor's wallet; the allocation request names them as observers.

paymentInstrumentId
string | null

The payment asset it commits and pays in, by its instrument id; absent, the one the fund takes, if it takes one.

Response

The same write again, with the same key and body; the operation it already is.

What every write answers: an operation, or an action awaiting approval, told apart by state.

state
required

Where the write stands: an operation's state, or awaiting for an action awaiting its approvers.

Available options:
queued,
running,
succeeded,
failed
operationId
string

The operation's id.

kind
enum<string>

What the operation does.

Available options:
instrument.record,
policy.set,
admission-consent.propose,
instrument.pause,
holder.register,
holder.onboard,
holder.close,
holder.register-successor,
holder.set-attributes,
admission.offer,
admission.withdraw,
accepted-terms.accept,
subscription.claim,
subscription.withdraw,
subscription.deliver,
subscription.settle,
subscription.release,
primary-market.propose,
redemption.claim,
redemption.withdraw,
redemption.release,
redemption.settle,
dealing-cycle.open,
dealing-cycle.settle,
dealing-cycle.release,
standing-settlement.open,
standing-settlement.settle,
standing-settlement.pause,
standing-settlement.resume,
standing-settlement.close,
reserve.propose,
reserve.close,
lock-agreement.propose,
lock-agreement.release,
mint.start,
mint.cancel,
reserve-redemption.start,
reserve-redemption.cancel,
reserve-report.create,
amendment.propose,
amendment.withdraw,
provision-settlement.propose,
distribution.execute,
distribution.roll,
standing-approval.grant,
standing-approval.revoke,
holder.restrict,
holder.restrict-batch,
restriction.lift,
issuer-powers-agreement.propose,
issuer-powers-consent.offer,
holder.force-transfer,
holder.recover,
instrument.force-transfer,
instrument.recover,
hold.release,
external-account.map,
webhook.register,
webhook.remove,
webhook.test
resource
object

The record it acts on, and, once it succeeds, the record it created or changed.

request
any | null

The body the operation was opened with, beside the ids its path named.

result
any | null

What the operation came to, once succeeded; null otherwise.

problem
any | null

The problem the operation failed with; null otherwise.

actor
string

Who asked, by sub.

actorName
string | null

The name claim of the bearer that asked; null where it carried none, and for an operation the engine opened itself.

actorEmail
string | null

The email claim of the bearer that asked; null where it carried none, and for an operation the engine opened itself.

role
enum<string> | null

The role the operation ran under; null for an operation the engine opened itself, whose actor names it.

Available options:
operator,
approver,
risk,
compliance,
auditor,
investor,
app,
monitor,
feed,
registrar
createdAt
string

When the operation was opened.

startedAt
string | null

When the operation started running; null while queued.

finishedAt
string | null

When the operation finished; null until it does.

updateId
string | null

The ledger update the operation committed; null until it commits.

offset
integer<int64> | null

The offset the operation's transaction committed at; null until it commits.

actionKey
string

The four-eyes action's key.

maker
string

Who made the action, by sub.

makerRole
enum<string>

The role the maker acted in.

Available options:
operator,
approver,
risk,
compliance,
auditor,
investor,
app,
monitor,
feed,
registrar
madeAt
string

When the maker made the action.

required
integer<int32>

How many distinct approvers the action needs.

signedBy
string[]

The approvers who have signed it so far.

recovery
string

What completes the action awaiting approval.