REST

The Anyone Network comes with a series of public REST APIs accessible by anyone who wants to investigate the live status of the network or their specific relay. This API complements the older Arweave metrics dumps that can be investigated by GraphQL requests (section coming soon).

The official domain for our technical endpoints is https://anyone.tech

And the API is accessible at https://api.ec.anyone.tech

API Specification

Network-Wide API

{
all: Total number of relays visible in latest consensus file,
offline: Relays recently running but currently offline,
online: Relays currently online
}

Total Active Relays (Over Time) https://api.ec.anyone.tech/total-relays

{
all[]: Total relays in latest consensus file over time (hourly),
offline[]:  Total relays recently offline over time (hourly),
online[]:  Total relays online over time (hourly)
}

{
all: Sum of observed bandwidth for all relays in consensus file.
offline: Sum of observed bandwidth for all recently offline relays.
online: Sum of observed bandwidth for all offline relays
}

Total Network Bandwidth (Over Time) https://api.ec.anyone.tech/total-observed-bandwidth

{
all: Sum of observed bandwidth for all relays in consensus file over time.
offline: Sum of observed bandwidth for all recently offline relays over time.
online: Sum of observed bandwidth for all offline relays over time. 
}

Additional parameters to be appended at the end of the query

from: T – start time (s, m, d)
to: T – end time (s, m, d)
interval: interval 

Example: https://api-dev.dmz.ator.dev/total-relays?from=3d&to=now&interval=12h

[ // list of all relays as H3 datapoints 
    {
    "index: Unique H3 Hex ID
    "relayCount": Number of relays situated in the area of this cell
    "geo": Center of cell coordinates
    "boundary"[]: Cell boundary coordinates
    },
]

{
"fingerprint": fingerprint of the relay,
"running": whether the relay is running,
"consensus_weight": Consensus weight score 
}

{
isAnon: Whether the un
IP: Your IP address visible to external sites
}

(Visual) Tells you whether you have routed through Anon.

POST APIs

Hardware Authentication Endpoint https://api.ec.anyone.tech/relays

Other Environments

To search for your relay in the stage environment: 🔗 https://api-stage.ec.anyone.tech

Last updated