Ethereum Data API

Ethereum Data API is a collection of APIs that expose read data from the Ethereum network.

Get latest status of the Ethereum protocol

Get global information about protocol token supplies

get

/eth/v0/status

Authorizations

Responses

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

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

200

401

403

500

200

{
  "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 global information about protocol token supplies at a given block number

get

/eth/v0/status/{block_number}

Authorizations

Path parameters

block_numberintegerrequired

Block height to query

Responses

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

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

200

401

403

500

200

{
  "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

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

get

/eth/v0/balances

Authorizations

Query parameters

addressesstring

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

block_numberinteger

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

limitinteger

Limit of elements to return (100 by default)

Responses

application/json

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

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

200

400

401

403

500

200

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

OK

Get LsETH balance of a given address

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

get

/eth/v0/balances/{address}

Authorizations

Path parameters

addressstringrequired

Account address to query the balance for

Query parameters

block_numberinteger

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

Responses

application/json

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

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

200

400

401

403

500

200

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

OK

Get LsETH balance history

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

get

/eth/v0/balances/{address}/history

Authorizations

Path parameters

addressstringrequired

Address of the balance to query balance for

Query parameters

from_blockinteger

Starting block height to query (0 by default)

to_blockinteger

Ending block height to query (latest by default)

limitinteger

Limit of elements to return (100 by default)

Responses

application/json

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

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

200

400

401

403

500

200

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

OK

List the smart contracts

List all the smart contracts addresses used

get

/eth/v0/contracts

Authorizations

Responses

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

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

200

401

403

500

200

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

OK