Ethereum

PreviousStake NextPolygon

Last updated 9 days ago

List unstakeable positions

get

Returns a list of positions that can be unstaked.

Authorizations

Query parameters

accountIdstringOptional

The account ID to list unstakeable positions for

Header parameters

x-client-idstringRequired

x-connection-idstringRequired

The provider connection through which the resource is accessed

AuthorizationstringOptional

Responses

application/json

objectOptional

application/json

get

GET /v1/provider/ethereum/unstakeable-positions HTTP/1.1
Host: auth.armory.playnarval.com
detached-jws: YOUR_API_KEY
x-client-id: text
x-connection-id: text
Accept: */*

{
  "data": [
    {
      "positionId": "text",
      "status": "opening",
      "provider": "text",
      "externalStatus": "text",
      "networkId": "text",
      "accountId": "text",
      "clientId": "text",
      "connectionId": "text"
    }
  ]
}

Get unstake by ID

get

Returns a specific unstake request by ID.

Authorizations

Path parameters

unstakeIdstringRequired

The unstake ID to retrieve

Header parameters

x-client-idstringRequired

x-connection-idstringRequired

The provider connection through which the resource is accessed

AuthorizationstringOptional

Responses

application/json

objectOptional

application/json

get

GET /v1/provider/ethereum/unstakes/{unstakeId} HTTP/1.1
Host: auth.armory.playnarval.com
detached-jws: YOUR_API_KEY
x-client-id: text
x-connection-id: text
Accept: */*

{
  "data": {
    "unstakeRequest": {
      "unstakeId": "text",
      "provider": "anchorage",
      "createdAt": null,
      "networkId": "text",
      "externalId": "text",
      "accountId": "text",
      "clientId": "text",
      "connectionId": "text",
      "status": "pending_approval",
      "externalStatus": "text"
    },
    "transactions": [
      {
        "externalTxId": "text",
        "externalTransactionStatus": "text"
      }
    ]
  }
}

Get stake by ID

get

Returns a specific stake request by ID.

Authorizations

Path parameters

stakeIdstringRequired

Header parameters

x-client-idstringRequired

x-connection-idstringRequired

The provider connection through which the resource is accessed

AuthorizationstringOptional

Responses

application/json

objectOptional

application/json

get

GET /v1/provider/ethereum/stakes/{stakeId} HTTP/1.1
Host: auth.armory.playnarval.com
detached-jws: YOUR_API_KEY
x-client-id: text
x-connection-id: text
Accept: */*

{
  "data": {
    "stakeRequest": {
      "stakeRequestId": "text",
      "provider": "anchorage",
      "createdAt": null,
      "networkId": "text",
      "externalId": "text",
      "accountId": "text",
      "clientId": "text",
      "connectionId": "text",
      "providerSpecific": null,
      "status": "pending_approval",
      "externalStatus": "text"
    },
    "positions": [
      {
        "positionId": "text",
        "status": "opening",
        "provider": "text",
        "externalStatus": "text",
        "networkId": "text",
        "accountId": "text",
        "clientId": "text",
        "connectionId": "text"
      }
    ],
    "transactions": [
      {
        "externalTxId": "text",
        "externalTransactionStatus": "text"
      }
    ]
  }
}

Create stake

post

Creates a new stake request on the provider.

Authorizations

Header parameters

x-client-idstringRequired

x-connection-idstringRequired

The provider connection through which the resource is accessed

AuthorizationstringOptional

Body

Request to stake tokens on an account. Will result in one or multiple stake positions.

sourceobjectRequired

createdAtanyOptional

validatorobjectRequired

amountstringRequired

idempotenceIdstringRequired

stakeRequestIdstringOptional

Sets the stake ID to an arbitrary value.

memostringOptional

providerSpecificanyOptional

Responses

application/json

objectOptional

application/json

post

POST /v1/provider/ethereum/stakes HTTP/1.1
Host: auth.armory.playnarval.com
detached-jws: YOUR_API_KEY
x-client-id: text
x-connection-id: text
Content-Type: application/json
Accept: */*
Content-Length: 210

{
  "source": {
    "type": "account",
    "id": "text"
  },
  "createdAt": null,
  "validator": {
    "address": "text",
    "externalId": "text"
  },
  "amount": "text",
  "idempotenceId": "text",
  "stakeRequestId": "text",
  "memo": "text",
  "providerSpecific": null
}

{
  "data": {
    "stakeRequest": {
      "stakeRequestId": "text",
      "provider": "anchorage",
      "createdAt": null,
      "networkId": "text",
      "externalId": "text",
      "accountId": "text",
      "clientId": "text",
      "connectionId": "text",
      "providerSpecific": null,
      "status": "pending_approval",
      "externalStatus": "text"
    },
    "positions": [
      {
        "positionId": "text",
        "status": "opening",
        "provider": "text",
        "externalStatus": "text",
        "networkId": "text",
        "accountId": "text",
        "clientId": "text",
        "connectionId": "text"
      }
    ],
    "transactions": [
      {
        "externalTxId": "text",
        "externalTransactionStatus": "text"
      }
    ]
  }
}

Create unstake

post

Creates a new unstake request on the provider.

Authorizations

Header parameters

x-client-idstringRequired

x-connection-idstringRequired

The provider connection through which the resource is accessed

AuthorizationstringOptional

Body

Request to unstake from a specific stake position.

amountstringRequired

idempotenceIdstringRequired

stakePositionIdstringRequired

sourceobjectRequired

unstakeIdstringOptional

Sets the unstake ID to an arbitrary value.

Responses

application/json

objectOptional

application/json

post

POST /v1/provider/ethereum/unstakes HTTP/1.1
Host: auth.armory.playnarval.com
detached-jws: YOUR_API_KEY
x-client-id: text
x-connection-id: text
Content-Type: application/json
Accept: */*
Content-Length: 124

{
  "amount": "text",
  "idempotenceId": "text",
  "stakePositionId": "text",
  "source": {
    "type": "account",
    "id": "text"
  },
  "unstakeId": "text"
}

{
  "data": {
    "unstakeRequest": {
      "unstakeId": "text",
      "provider": "anchorage",
      "createdAt": null,
      "networkId": "text",
      "externalId": "text",
      "accountId": "text",
      "clientId": "text",
      "connectionId": "text",
      "status": "pending_approval",
      "externalStatus": "text"
    },
    "transactions": [
      {
        "externalTxId": "text",
        "externalTransactionStatus": "text"
      }
    ]
  }
}