/ethereals/:address

You need an API key for this call. Please reach out to the Blessnet team to get setup.

GET /ethereals/:address

The /etherals:/address endpoint returns details of a specific ethereal account.

Headers

Name	Value
x-api-key	Your API key

Path Variables

Name	Mandatory?	Default	Value
:address	Yes		The ethereal address you are querying

Params

Name	Mandatory?	Default	Value
chain	No	mainnet	The chain type we are working with, either mainnet or sepolia

Response Body

The response provides an array of etherealData objects with a single nextCursor value providing the cursor for the next page. If this is null there is no next page.

The etherealData objects have the following properties:

Name	Type	Description
_id	string	The unique Id for this transfer
ethereal	string	The contract address of the ethereal collection.
status	string	The status of the ethereal. Possible values are: - active - unfunded (funds are below the level required for synchronisation.
balance	string	The balance of the ethereal contract.
sourceChain	string	The source chain for the contract being mirrored..
sourceContract	string	The source contract being mirrored.
tokenName	string	The name of the ethereal contract.
tokenSymbol	string	The symbol of the ethereal contract.
lastCheckedTimestamp	number	Unix timestamp of when this was last checked.
lastCheckedDate	string	Date object of when this was last checked.
lastSyncTimestamp	number	Unix timestamp of when this was last synced.
lastSyncData	string	Date object of when this was last synced.
deposits	array	Array of objects detailing the ethereal's deposit history.

Example Request

GET https://api.bless.net/ethereals/0x61dcf30947a1d7f67a0b61dfcefc4e842724d66b?chain=sepolia

Response

200

{
    "etherealData": {
        "_id": "67c2fa24cf1e3ed713202e89",
        "ethereal": "0x61dcf30947a1d7f67a0b61dfcefc4e842724d66b",
        "status": "active",
        "balance": "1099756711100000000",
        "sourceChain": "1",
        "sourceContract": "0xe77c4e5e17ea350993cac2eb48bb50dbcccc956b",
        "tokenName": "Ethereal EtherTree",
        "tokenSymbol": "ETREE",
        "lastCheckTimestamp": 1740953590,
        "lastCheckDate": "2025-03-02T22:13:10.793Z",
        "lastSyncTimestamp": 1740953590,
        "lastSyncDate": "2025-03-02T22:13:10.793Z",
        "deposits": [
            {
                "timestamp": 1740831267,
                "depositor": "0xB95511Bfc49F2F90D3B828233AAb40aFA566fF62",
                "deposit": "1000000000000000"
            },
            {
                "timestamp": 1740943235,
                "depositor": "0x61bF58101f64b178d6433865B7EFA59c2A30ba9B",
                "deposit": "1100000000000000000"
            }
        ]
    }
}