/ethereals

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

GET /ethereals

The /etherals endpoint returns details of all ethereals for the given query parameters

Headers

Name	Value
x-api-key	Your API key

Params

Name	Mandatory?	Default	Value
chain	No	mainnet	The chain type we are working with, either mainnet or sepolia
sourceChains	No		A comma separated list of the source chain that the mirrored NFT is from must be from, e.g. 1,42161
sourceContracts	No		A comma separated list of source contracts.
statuses	No		A comma separated list statuses to filter by Possible values: - active - unfunded
page_size	No	50	The number of records to return per page.
cursor	No	null	The cursor representing the start point of the next page of results.

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?chain=sepolia

Response

200

{
    "etherealData": [
        {
            "_id": "67c16c15cf1e3ed713ed3729",
            "ethereal": "0x026a2faee3eae0ebacb304b66645665f053c18e8",
            "status": "unfunded",
            "balance": "99986648500000000",
            "sourceChain": "1",
            "sourceContract": "0xbd3531da5cf5857e7cfaa92426877b022e612cf8",
            "tokenName": "Ethereal PudgyPenguins",
            "tokenSymbol": "PPG",
            "lastCheckTimestamp": 1740730061,
            "lastCheckDate": "2025-02-28T08:07:41.188Z",
            "deposits": [
                {
                    "timestamp": 1740729365,
                    "depositor": "0x61bF58101f64b178d6433865B7EFA59c2A30ba9B",
                    "deposit": "100000000000000000"
                }
            ]
        },
        {
            "_id": "67c169fbcf1e3ed713ecf3e7",
            "ethereal": "0x66ec75286130bc2a39432e6bf6a5051238a93d4d",
            "status": "active",
            "balance": "1466976964900000000",
            "sourceChain": "1",
            "sourceContract": "0x1d20a51f088492a0f1c57f047a9e30c9ab5c07ea",
            "tokenName": "Ethereal loomlocknft",
            "tokenSymbol": "LL",
            "lastCheckTimestamp": 1740730061,
            "lastCheckDate": "2025-02-28T08:07:41.188Z",
            "lastSyncTimestamp": 1740730061,
            "lastSyncDate": "2025-02-28T08:07:41.188Z",
            "deposits": [
                {
                    "timestamp": 1740728827,
                    "depositor": "0x61bF58101f64b178d6433865B7EFA59c2A30ba9B",
                    "deposit": "100000000000000000"
                }
            ]
        }
    ],
    "nextCursor": null
}