/ethereals/:chainId/:address

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

GET /ethereals/:chainId/:address

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

Headers

Name	Value
x-api-key	Your API key

Path Variables

Name	Mandatory?	Default	Value
:chainId	Yes		the chain the source token lives on
:address	Yes		The source token address you are querying

Response Body

The response provides an ethereal object structured as follows:

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.
lastCheckedAt	Date	Unix date
lastSyncedAt	number	Unix timestamp 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/1/0xe77c4e5e17ea350993cac2eb48bb50dbcccc956b

Response

200

{
    "ethereal": {
        "_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"
            }
        ]
    }
}