Onionoo API

Summary from https://metrics.torproject.org/onionoo.html#uptime

Endpoints:

• /details

• /bandwidth

• /weights

• `/clients

• /uptime

• /summary

Parameters:

• For /search:
  • fp
  • nickname
  • ip
  • hashed hex-encoded fingerprint
  • "qualified search term" in the form key:value. Possible keys:
    • ~~ search, fingerprint, order, limit, offset, fields~~'
    • 'as_name'
    • 'as'
    • 'contact'
    • 'country'
    • 'family'
    • 'first_seen_days'
    • 'flag'
    • 'host_name'
    • 'last_seen_days'
    • 'lookup' (fingerprint)
    • 'os'
    • 'recommended_version
    • 'running'
    • 'type'
    • 'version' For relay/bridge details response
    • fields
      • nickname
      • hashed_fingerprint
      • ?
• 'as_name'
• 'as'
• 'contact'
• 'country'
• 'family'
• 'first_seen_days'
• 'flag'
• 'host_name'
• 'last_seen_days'
• 'lookup'
• 'os'
• 'recommended_version
• 'running'
• 'type'
• 'version'

For relay/bridge documents:

• limit
• offset
• limit

Responses

• version'
• 'next_major_version_scheduled'
• 'build_revision'
• 'relays_published'
• 'relays_skipped'
• 'relays'
• 'relays_truncated'
• 'bridges_published'
• 'bridges_skipped'
• 'bridges'
• 'bridges_truncated

Details documents

Relay Details documents

• 'advertised_bandwidth'
• 'alleged_family'
• 'as'
• 'as_name'
• 'bandwidth_avg'
• 'bandwidth_burst'
• 'city_name'
• 'consensus_weight'
• 'consensus_weight_fraction'
• 'contact'
• 'country'
• 'country_name'
• 'dir_address'
• 'effective_family'
• 'exit_addresses'
• 'exit_policy'
• 'exit_policy_summary'
• 'exit_policy_v6_summary'
• 'exit_probability'
• 'fingerprint'
• 'first_seen'
• 'flags'
• 'guard_probability'
• 'hibernating'
• 'host_name'
• 'indirect_family'
• 'last_changed_address_or_port'
• 'last_restarted'
• 'last_seen'
• 'latitude'
• 'longitude'
• 'measured'
• 'middle_probability'
• 'nickname'
• 'observed_bandwidth'
• 'or_addresses'
• 'overload_general_timestamp'
• 'platform'
• 'recommended_version'
• 'region_name'
• 'running'
• 'unreachable_or_address'
• 'unverified_host_names'
• 'verified_host_names'
• 'version'
• 'version_status`

Bridge Details documents

• 'advertised_bandwidth'
• 'contact'
• 'first_seen'
• 'flags'
• 'last_restarted'
• 'last_seen'
• 'nickname'
• 'or_addresses'
• 'overload_general_timestamp'
• 'platform'
• 'recommended_version'
• 'running'
• 'version_status`
• 'version'
• blocklist
• bridgedb_distributor
• hashed_fingerprint
• transports

Graph History objects

• `first'
• 'last'
• 'interval'
• 'factor'
• 'count'
• 'values

Bandwidth documents

Relay bandwidth objects

• 'fingerprint'
• 'overload_fd_exhausted`
• 'overload_ratelimits'
• 'read_history'
• 'write_history'

Bridge bandwidth objects

^ same?

• 'fingerprint'
• 'overload_fd_exhausted`
• 'overload_ratelimits'
• 'read_history'
• 'write_history'

Weights documents

Relay weights objects

'

• 'fingerprint'
• 'consensus_weight_fraction'
• 'guard_probability'
• 'middle_probability'
• 'exit_probability'
• 'consensus_weight

Client documents

Bridge client objects

• 'average_clients'
• 'fingerprint`

Uptime documents

Relay Uptime objects

• 'fingerprint'
• 'flags'
• 'uptime`

Bridge Uptime objects

• 'fingerprint'
• 'uptime`