Propose stopping a sweep

POST

/v1/sweeps/{id}/stop

const url = 'https://api.sotirea.com/v1/sweeps/1/stop';
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://api.sotirea.com/v1/sweeps/1/stop \
  --header 'Authorization: Bearer <token>'

The sweep keeps running until a person who manages sweeps, and has never held this key’s secret, confirms in the console.

Authorizations

bearer

Parameters

Path Parameters

required

integer

The active sweep’s id.

Responses

201

Done.

application/json

object

data

required

object

asset

required

Native, or a token’s contract.

string

chain_id

required

string

chain_name

required

string

coin_decimals

required

integer

coin_symbol

required

The network’s coin, which pays the fees.

string

decided_at

required

Any of:

string
null

string format: date-time

decided_by

string

decimals

The asset’s decimals; absent for a token whose contract has not been read.

integer

destination_vault_id

required

integer

destination_vault_name

required

string

every_referenced_vault

required

Whether it sweeps every vault opened with a reference: each customer’s deposit vault, including those opened later.

boolean

fee_ceiling

required

The most one sweep may cost in network fees, in the network coin’s smallest unit.

string

required

integer

last_run

required

Any of:

object
null

object

required

string format: date-time

detail

What happened, vault by vault, in words.

string

outcome

required

Swept; nothing (no vault held the minimum); skipped (every sweep worth making was held back: the fee above the ceiling, or the gas pool unable to pay); or failed.

string

skipped_since

When the current run of skips began. After a day, the people who manage sweeps are emailed once.

string format: date-time

min_amount

required

The least a vault must hold free before it is swept, in the asset’s smallest unit.

string

proposed_at

required

string format: date-time

proposed_by

required

The person’s name, or the API key’s when a key proposed it.

string

proposed_by_api_key

required

Whether an API key proposed it. Nobody who has held that key’s secret may confirm it.

boolean

replaces_id

The rule a proposal changes or retires.

integer

retire

required

A proposal to stop the rule it replaces.

boolean

sole_manager

required

Confirmed by its proposer alone, because nobody else in your organisation manages sweeps.

boolean

source_vaults

required

The vaults it sweeps when it names them; empty when it sweeps every vault opened with a reference. Never the destination.

Array<object>

object

required

integer

name

required

string

state

required

Active, proposed (waiting for a second person), declined or retired.

string

symbol

required

string

meta

object

request_id

Quote it when asking about a request; it is in the X-Request-Id header too.

string

success

required

Example

{
  "success": true
}

default

Refused or failed, in words a person can act on.

application/json

object

error

required

object

code

required

string

fields

object

key

additional properties

string

message

required

string

meta

object

request_id

Quote it when asking about a request.

string

success

required

Example

{
  "success": false
}