SparkSeer API (1.0.0)

Download OpenAPI specification:Download

Authentication

SparkSeer currently offers authentication by API key

api_key

Manage your API keys on the Account page at https://sparkseer.space

Security Scheme Type: API Key
Header parameter name: api-key

Network-wide Stats

Summary statistics for the whole network and bulk stats for nodes

Nodes/Channels/Capacity

Pull historical summary information about publicly announced total capacity, nodes and channels

Responses

Request samples

curl "https://api.sparkseer.space/v1/stats/ln-summary-ts" -i -X GET

Response samples

Content type
application/json
{
  • "ln_summary": [
    ]
}

Centralities

Pull current centrality information computed by SparkSeer for all publicly visible nodes

Responses

Request samples

curl "https://api.sparkseer.space/v1/stats/centralities" -i -X GET

Response samples

Content type
application/json
{
  • "graph_timestamp": 1592312018,
  • "centralities": [
    ]
}

Node Stats

Summary statistics for specific nodes

Current node stats

Current node summary statistics

Authorizations:
api_key

Responses

Request samples

curl "https://api.sparkseer.space/v1/node/current-stats/{pubkey}" \ 
  -H 'api-key: your-api-key-here' \
  -i -X GET

Response samples

Content type
application/json
{
  • "pubkey": "03899f4a6c679c3a1bea61c3ba7bb0ac560f3d420286d1d898c5f83b8e0830844f",
  • "total_capacity": 210000000,
  • "num_channels": 69,
  • "mean_channel_capacity": 21000000.42,
  • "median_channel_capacity": 21000000,
  • "mean_outbound_base_fee": 1000,
  • "mean_outbound_fee_rate": 420,
  • "median_outbound_base_fee": 1000,
  • "median_outbound_fee_rate": 420,
  • "mean_inbound_base_fee": 1000,
  • "mean_inbound_fee_rate": 420,
  • "median_inbound_base_fee": 1000,
  • "median_inbound_fee_rate": 420,
  • "alias": "string",
  • "ipv4": "string",
  • "ipv6": "string",
  • "torv3": "string",
  • "last_update": 1592312018,
  • "betweenness_rank": 420,
  • "closeness_rank": 420,
  • "eigenvector_rank": 420,
  • "weighted_betweenness_rank": 420,
  • "weighted_closeness_rank": 420,
  • "weighted_eigenvector_rank": 420,
  • "htlc_response_time_mean": 2.69,
  • "htlc_response_time_median": 2,
  • "liquidity_flexibility_score": 69.21,
  • "effective_outbound_balance": 69.21,
  • "effective_inbound_balance": 69.21
}

Historical node stats

Historical node summary statistics. Default window is 14 days, 30 days with a Basic subscription, 90 days with a Standard, and 180 with a Premium.

Authorizations:
api_key

Responses

Request samples

curl "https://api.sparkseer.space/v1/node/historical/{pubkey}" \ 
  -H 'api-key: your-api-key-here' \
  -i -X GET

Response samples

Content type
application/json
{
  • "pubkey": "03899f4a6c679c3a1bea61c3ba7bb0ac560f3d420286d1d898c5f83b8e0830844f",
  • "historical_stats": [
    ]
}

Local network

Fetch a node's local network in HTML

Authorizations:
api_key

Responses

Request samples

curl "https://api.sparkseer.space/v1/node/local-network/{pubkey}" \ 
  -H 'api-key: your-api-key-here' \
  -i -X GET

Response samples

Content type
application/json
{
  • "code": 401,
  • "message": "Authentication failed"
}

Peers of peers in common

Fetch the number of nodes in common for each peer of a given node

Authorizations:
api_key

Responses

Request samples

curl "https://api.sparkseer.space/v1/node/peers-of-peers/{pubkey}" \ 
  -H 'api-key: your-api-key-here' \
  -i -X GET

Response samples

Content type
application/json
{
  • "peers": [
    ]
}

Peer triangles

Get all channel triangles between peers of a node

Authorizations:
api_key

Responses

Request samples

curl "https://api.sparkseer.space/v1/node/triangles/{pubkey}" \ 
  -H 'api-key: your-api-key-here' \
  -i -X GET

Response samples

Content type
application/json
{
  • "pubkey": "03899f4a6c679c3a1bea61c3ba7bb0ac560f3d420286d1d898c5f83b8e0830844f",
  • "triangles": [
    ]
}

Sats4stats

Sats4stats operations

Sats4probes

Get sats for your probes collected by LND's Mission Control daemon, or from data collected on your node running a different implementation (CLN/Eclair/etc.) using custom tools so you can generate a payload according to the request body schema. The maximum potential bid for probes, determined by the account subscription, can be found with the "Bid info" call. Payouts for probes are based on a number of factors, and may or may not reach the corresponding maximum bid.

Authorizations:
api_key
Request Body schema: application/json
Array of objects

Responses

Request samples

Content type
application/json
{
  • "pairs": [
    ]
}

Response samples

Content type
application/json
{
  • "receipt": {
    }
}

Payout info

Get info about previous sats4stats payouts

Authorizations:
api_key

Responses

Request samples

curl "https://api.sparkseer.space/v1/sats4stats/payouts" \ 
  -H 'api-key: your-api-key-here' \
  -i -X GET

Response samples

Content type
application/json
{
  • "payouts": [
    ]
}

Bid info

Get the latest bid maximum numbers. Bids are based on a number of factors such that payouts may fluctuate and may not always reach maximum bid.

Responses

Request samples

curl "https://api.sparkseer.space/v1/sats4stats/bidinfo" -i -X GET

Response samples

Content type
application/json
{
  • "routermc": {
    }
}

Services

Fetch data from subscription services

Channel recommendations

Fetch the table of channel recommendations as shown on https://sparkseer.space/chanrec. Requires a subscription to access.

Authorizations:
api_key

Responses

Request samples

curl "https://api.sparkseer.space/v1/services/channel-recommendations" \ 
  -H 'api-key: your-api-key-here' \
  -i -X GET

Response samples

Content type
application/json
{
  • "channel_recommendations": [
    ]
}

Outbound liquidity value

Outbound liquidity value based on current channel fees with respect to other nodes. Requires a subscription to access.

Authorizations:
api_key

Responses

Request samples

curl "https://api.sparkseer.space/v1/services/outbound-liquidity-value" \ 
  -H 'api-key: your-api-key-here' \
  -i -X GET

Response samples

Content type
application/json
{
  • "channel_peers": [
    ]
}

Suggested channel fees

Get suggestions for channel fees on existing channels on your node for both passive and active rebalancing strategies. Requires a subscription to access.

Authorizations:
api_key

Responses

Request samples

curl "https://api.sparkseer.space/v1/services/suggested-fees" \ 
  -H 'api-key: your-api-key-here' \
  -i -X GET

Response samples

Content type
application/json
{
  • "channel_peers": [
    ]
}