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).
API Specification
Network-Wide API
Total Active Relays (Latest)
https://api.ec.anyone.tech/total-relays-latest
{
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)
}
Total Network Bandwidth
https://api.ec.anyone.tech/total-observed-bandwidth-latest
{
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
Relay Map
https://api.ec.anyone.tech/relay-map
[ // 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
},
]
Per-User Search
Relay Lookup
https://api.ec.anyone.tech/relays/
{
"fingerprint": fingerprint of the relay,
"running": whether the relay is running,
"consensus_weight": Consensus weight score
}
Anon Check (API)
https://check.en.anyone.tech/api/ip
{
isAnon: Whether the un
IP: Your IP address visible to external sites
}
Anon Check (UI)
https://check.en.anyone.tech
(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