Amboss
Search…
Nodes

Node Information

With this query you can get graph information and social information for a specific node.

Authentication

This is a public endpoint. No authentication is needed to get this information.

Variables

Variable
Details
Field
NODE PUBLIC KEY
Public key of the node we want information from
getNode

Fields

1
{
2
getNode(
3
pubkey: NODE_PUBLIC_KEY
4
) {
5
graph_info {
6
node {
7
addresses {
8
addr
9
network
10
}
11
alias
12
color
13
features {
14
feature_id
15
is_known
16
is_required
17
name
18
}
19
last_update
20
pub_key
21
}
22
channels {
23
num_channels
24
total_capacity
25
channel_info {
26
age {
27
max
28
min
29
mean
30
median
31
sum
32
}
33
capacity {
34
max
35
mean
36
median
37
min
38
sum
39
}
40
}
41
fee_info {
42
local {
43
max
44
min
45
mean
46
median
47
weighted
48
}
49
remote {
50
max
51
min
52
mean
53
median
54
weighted
55
}
56
}
57
list {
58
block_age
59
long_channel_id
60
short_channel_id
61
chan_point
62
capacity
63
node1_pub
64
node2_pub
65
last_update
66
node1_policy {
67
disabled
68
fee_base_msat
69
fee_rate_milli_msat
70
last_update
71
max_htlc_msat
72
min_htlc
73
time_lock_delta
74
}
75
node2_policy {
76
disabled
77
fee_base_msat
78
fee_rate_milli_msat
79
last_update
80
max_htlc_msat
81
min_htlc
82
time_lock_delta
83
}
84
}
85
}
86
}
87
socials {
88
communities {
89
background
90
border
91
name
92
pubId
93
}
94
info {
95
custom_url
96
email
97
logo
98
message
99
minChannelSize
100
private
101
pubkey
102
telegram
103
twitter
104
twitter_verified
105
updated
106
website
107
lightning_address
108
}
109
is_favorite
110
lightning_labs {
111
is_bos
112
is_bos_past_week
113
terminal_web {
114
centrality
115
centrality_normalized
116
good_inbound_peers
117
good_outbound_peers
118
position
119
score
120
stable_inbound_peers
121
stable_outbound_peers
122
total_peers
123
}
124
}
125
zion_info {
126
is_zion
127
}
128
}
129
}
130
}
Copied!

Examples

All the fields above can be mixed and matched to request just the information that you need. Here are some common examples to fetch information.

Get Channel Information

If you want to request the channel age and capacity resume for a node you can get the necessary information with this query.
1
{
2
getNode(
3
pubkey: "02f63f49339c8b438c3291ab21e35d1b5642ac2360240068b5ecd3fd5183f2c042"
4
) {
5
graph_info {
6
channels {
7
channel_info {
8
age {
9
max
10
min
11
mean
12
median
13
sum
14
}
15
capacity {
16
max
17
mean
18
median
19
min
20
sum
21
}
22
}
23
}
24
}
25
}
26
}
Copied!

Get Channel Details

If you want to get the capacity and block age for a nodes public channels you can get the necessary information with this query.
1
{
2
getNode(
3
pubkey: "02f63f49339c8b438c3291ab21e35d1b5642ac2360240068b5ecd3fd5183f2c042"
4
) {
5
graph_info {
6
channels {
7
list {
8
block_age
9
capacity
10
}
11
}
12
}
13
}
14
}
Copied!

Get Social Information

If you want to get the communities and the twitter account for this node you can get the necessary information with this query.
1
{
2
getNode(
3
pubkey: "02f63f49339c8b438c3291ab21e35d1b5642ac2360240068b5ecd3fd5183f2c042"
4
) {
5
socials {
6
communities {
7
name
8
}
9
info {
10
twitter
11
}
12
}
13
}
14
}
Copied!
Last modified 3mo ago