jsinfo/swagger.yml at main · lavanet/jsinfo · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
swagger: '2.0'
info:
  title: Lava Network Public API
  description: API for interacting with the Lava Network, including health checks, providers, and blockchain data.
  version: 1.0.0
host: jsinfo.mainnet.lavanet.xyz
basePath: /
schemes:
  - https
paths:
  /health:
    get:
      summary: Basic health check
      description: Returns the health status of the API.
      responses:
        200:
          description: Health check response
          schema:
            type: object
            properties:
              health:
                type: string
                example: "ok"

  /latest:
    get:
      summary: Latest block height and datetime
      description: Used for monitoring blockchain sync status.
      responses:
        200:
          description: Latest block details
          schema:
            type: object
            properties:
              height:
                type: integer
                example: 2200221
              datetime:
                type: integer
                example: 1710371763

  /islatest:
    get:
      summary: Check if block data is up-to-date
      description: Returns block height, datetime, and freshness status.
      responses:
        200:
          description: Block data freshness status
          schema:
            type: object
            properties:
              height:
                type: integer
                example: 2200221
              datetime:
                type: integer
                example: 1710371763
              status:
                type: string
                example: "fresh"

  /listProviders:
    get:
      summary: List all Lava Network providers
      description: Returns comprehensive details about all providers, including staking and commission information.
      responses:
        200:
          description: List of providers
          schema:
            type: array
            items:
              type: object
              properties:
                address:
                  type: string
                  example: "lava@valoper1qtjgjmc7w9tfem4dn8epzehfp4axk927gphyze"
                moniker:
                  type: string
                  example: "P-ops Team"
                commission:
                  type: object
                  properties:
                    rate:
                      type: string
                      example: "0.1"
                    max_rate:
                      type: string
                      example: "0.2"
                    max_change_rate:
                      type: string
                      example: "0.1"

  /providers:
    get:
      summary: List all providers
      description: Returns addresses of all Lava Network providers.
      responses:
        200:
          description: List of provider addresses
          schema:
            type: array
            items:
              type: string
              example: "lava@valoper1qtjgjmc7w9tfem4dn8epzehfp4axk927gphyze"

  /supply/circulating:
    get:
      summary: Get circulating supply of LAVA tokens
      description: Returns the current circulating supply of LAVA tokens.
      responses:
        200:
          description: Circulating supply of LAVA
          schema:
            type: string
            example: "1000000000"

  /supply/total:
    get:
      summary: Get total supply of LAVA tokens
      description: Returns the total supply of LAVA tokens.
      responses:
        200:
          description: Total supply of LAVA
          schema:
            type: string
            example: "2000000000"

  /stakers_and_restakers:
    get:
      summary: Stakers and restakers statistics
      description: Returns comprehensive statistics about stakers and restakers across the Lava Network.
      responses:
        200:
          description: Staker and restaker statistics
          schema:
            type: object
            properties:
              lastUpdated:
                type: string
                example: "2025-03-05T15:19:44.512Z"
              lavaUsdRate:
                type: number
                format: float
                example: 0.075727
              activeProviders:
                type: object
                properties:
                  providers:
                    type: array
                    items:
                      type: string
                      example: "lava@1pew9nxdepfnap3mkkcmvkemls4c5uets9rqq2h"
                  data:
                    type: object
                    properties:
                      allTime:
                        type: object
                        properties:
                          stakers:
                            type: object
                            properties:
                              count:
                                type: integer
                                example: 5897
                              totalUSD:
                                type: number
                                format: float
                                example: 51682345.263304494
                              totalLava:
                                type: number
                                format: float
                                example: 682482407.375236