Sign in

Returns a consensus layer account.

Changed on
get/consensus/accounts/{address}

Request

  • Base URL: https://nexus.oasis.io/v1
  • URL: https://nexus.oasis.io/v1/consensus/accounts/{address}
  • Auth: none declared

Path parameters

addressstring required

An Oasis-style (bech32) address.

Example:oasis1qpg2xuz46g53737343r20yxeddhlvc2ldqsjh70p

The staking address of the account to return.

Response

A JSON object containing a consensus layer account.

addressstring required

The staking address for this account.

nonceinteger required

The expected nonce for the next transaction (= last used nonce + 1)

availablestring bigint required
escrowstring bigint required
debondingstring bigint required
delegations_balancestring bigint required
debonding_delegations_balancestring bigint required
first_activitystring date-time

The second-granular consensus time of the block in which this account was first active. Dates before Cobalt (2021-04-28) are approximate.

entity_node_forstring

The entity address, if this account is a node belonging to an entity. Only present when querying a single account.

entitystring

The entity address, if this account is an entity. If present, this address should match the queried address.

Example response

{
  "address": "oasis1qpg2xuz46g53737343r20yxeddhlvc2ldqsjh70p",
  "available": "1234567890123456789012",
  "escrow": "1234567890123456789012",
  "debonding": "1234567890123456789012",
  "delegations_balance": "1234567890123456789012",
  "debonding_delegations_balance": "1234567890123456789012",
  "first_activity": "2022-03-01T00:00:00Z",
  "allowances": [
    {
      "address": "oasis1qprtzrg97jk0wxnqkhxwyzy5qys47r7alvfl3fcg",
      "amount": "1234567890123456789012"
    }
  ],
  "stats": {
    "total_sent": "1234567890123456789012",
    "total_received": "1234567890123456789012",
    "num_txns": 4184
  },
  "entity_node_for": "oasis1qprtzrg97jk0wxnqkhxwyzy5qys47r7alvfl3fcg",
  "entity": "oasis1qprtzrg97jk0wxnqkhxwyzy5qys47r7alvfl3fcg"
}

Changes

  • v1d3c803ebd03dRevision changes
    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • v1d1b11b07847dRevision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status