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

Main 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

Additional API Endpoints

Current Status

All-Time Rewards

Retrieves the all-time earned rewards for a given wallet across all their relays.

https://relay-api.anyone.io/api/rewards/all-time/<wallet>

Relays Associated to One Wallet

Returns an object with all of the relays associated to one wallet. Used for integration with the Moken DePIN tracker.

https://relay-api.anyone.io/api/miners/<wallet>

Output:

[{
    "deviceId", // fingerprint 
    "type": "ANYONE", // fixed: project name 
    "friendlyName", // relay nickname 
  },

Rewards in Latest Epoch

Returns an object with the amount of tokens earnt by a relay in the last epoch, and epoch details

https://relay-api.anyone.io/api/rewards/<fingerprint>

Output:

{
    "date", // date and timestamp of epoch 
    "amount": // amount of tokens
    "tokenSymbol", // fixed: ANYONE
},

Other Environments

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