Ethereum Data API

Get latest status of the Ethereum protocol

get

Get global information about protocol token supplies

Authorizations

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.alluvial.finance/eth/v0/status' \
  --header 'Authorization: Bearer JWT'

200

401

403

500

{
  "active_validator_count": 58,
  "active_validators_eth_balance": "128000000000000000000",
  "block_number": 15034284,
  "collected_rewards": "3200000000000000000000",
  "contract_eth_balance": "5000000000000000000",
  "conversion_rate": 1,
  "deposit_count": 2,
  "exited_validators_eth_balance": "128000000000000000000",
  "exiting_validators_eth_balance": "128000000000000000000",
  "funded_validator_count": 102,
  "funded_valitor_count": 102,
  "pending_validator_count": 2,
  "pending_validators_eth_balance": "64000000000000000000",
  "rebalance_deposit_to_redeem_mode": true,
  "skimmed_validators_eth_balance": "128000000000000000000",
  "slashing_containment_mode": false,
  "stopped_validator_count": 42,
  "total_eth_balance": "3200000000000000000000",
  "total_eth_deposited": "3200000000000000000000",
  "total_supply": "3200000000000000000000",
  "total_validator_count": 100
}

OK

Get status of the Ethereum protocol at a given block number

get

Get global information about protocol token supplies at a given block number

Authorizations

Path parameters

block_numberintegerrequired

Block height to query

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.alluvial.finance/eth/v0/status/{block_number}' \
  --header 'Authorization: Bearer JWT'

200

401

403

500

{
  "active_validator_count": 58,
  "active_validators_eth_balance": "128000000000000000000",
  "block_number": 15034284,
  "collected_rewards": "3200000000000000000000",
  "contract_eth_balance": "5000000000000000000",
  "conversion_rate": 1,
  "deposit_count": 2,
  "exited_validators_eth_balance": "128000000000000000000",
  "exiting_validators_eth_balance": "128000000000000000000",
  "funded_validator_count": 102,
  "funded_valitor_count": 102,
  "pending_validator_count": 2,
  "pending_validators_eth_balance": "64000000000000000000",
  "rebalance_deposit_to_redeem_mode": true,
  "skimmed_validators_eth_balance": "128000000000000000000",
  "slashing_containment_mode": false,
  "stopped_validator_count": 42,
  "total_eth_balance": "3200000000000000000000",
  "total_eth_deposited": "3200000000000000000000",
  "total_supply": "3200000000000000000000",
  "total_validator_count": 100
}

OK

List LsETH balance of several addresses

get

List LsETH balance of several addresses It is possible to specify for which block and which addresses to get the balances.

Authorizations

Query parameters

addressesstringoptional

Comma separated list of addresses (if empty returns all addresses)

block_numberintegeroptional

Block number at which to get balance for (latest by default)

limitintegeroptional

Limit of elements to return (100 by default)

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.alluvial.finance/eth/v0/balances' \
  --header 'Authorization: Bearer JWT'

200

400

401

403

500

[
  {
    "address": "0x123456789985ca04a69c35978c3a3e778d6ef172",
    "balance": "4200000000000000000000",
    "block_number": 15034284
  }
]

OK

Get LsETH balance of a given address

get

Get LsETH balance of a given address It is possible to specify for which block to get the balance at.

Authorizations

Path parameters

addressstringrequired

Account address to query the balance for

Query parameters

block_numberintegeroptional

Block number at which to get balance for (latest by default)

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.alluvial.finance/eth/v0/balances/{address}' \
  --header 'Authorization: Bearer JWT'

200

400

401

403

500

{
  "address": "0x123456789985ca04a69c35978c3a3e778d6ef172",
  "balance": "4200000000000000000000",
  "block_number": 15034284
}

OK

Get LsETH balance history

get

Get the LsETH balance history for a given address It returns a balance object for every block a balance change occurred It is possible to filter the history for a range only blocks

Authorizations

Path parameters

addressstringrequired

Address of the balance to query balance for

Query parameters

from_blockintegeroptional

Starting block height to query (0 by default)

to_blockintegeroptional

Ending block height to query (latest by default)

limitintegeroptional

Limit of elements to return (100 by default)

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.alluvial.finance/eth/v0/balances/{address}/history' \
  --header 'Authorization: Bearer JWT'

200

400

401

403

500

[
  {
    "address": "0x123456789985ca04a69c35978c3a3e778d6ef172",
    "balance": "4200000000000000000000",
    "block_number": 15034284
  }
]

OK

List the smart contracts

get

List all the smart contracts addresses used

Authorizations

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.alluvial.finance/eth/v0/contracts' \
  --header 'Authorization: Bearer JWT'

200

401

403

500

{
  "allowlister": [
    1
  ],
  "deployment_block": 1,
  "el_fee_recipient": [
    1
  ],
  "operators_registry": [
    1
  ],
  "oracle": [
    1
  ],
  "redeem_manager": [
    1
  ],
  "river": [
    1
  ],
  "withdraw": [
    1
  ]
}

OK