API Reference

Nept

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Get NEPT token state

GET/api/v1/nept/state

Get NEPT token state

Query ParametersExpand Collapse

with_text: optional boolean

Include text variation fields

with_value: optional boolean

Calculate and include USD values for amounts, where applicable

ReturnsExpand Collapse

data: NeptState { extra, staking, total_claimed, 3 more }

extra: object { text, value }

text: object { total_claimed, total_issued, total_locked, total_supply }

Human-readable field variants. Will not be null when query param with_text is true.

total_claimed: string

total_issued: string

total_locked: string

total_supply: string

value: object { extra, price, total_claimed, 3 more }

USD values for the corresponding amounts above. Will not be null when query param with_value is true.

Note

This variant group contains an additional price field (set to the number used in value calculation).

The embedded text group will contain the text variant if with_text was specified as well.

extra: object { text }

text: object { price, total_claimed, total_issued, 2 more }

Human-readable variants of USD values. Will not be null when query params with_text and with_value are true.

price: string

Text representation of price

total_claimed: string

total_issued: string

total_locked: string

total_supply: string

price: string

Price used in value calculations

total_claimed: string

total_issued: string

total_locked: string

total_supply: string

staking: array of object { duration, extra, index, state }

Staking pools (current pool state is included)

duration: number

The lockup duration for this pool in seconds

formatuint64

minimum0

extra: object { text }

text: object { duration, index }

Human-readable field variants. Will not be null when query param with_text is true.

duration: string

index: string

index: number

The ordered index (position) of this pool

formatuint8

minimum0

maximum255

state: StakingPoolState { extra, total_bonded }

Current contract state of staking pool

extra: object { text, value }

text: object { total_bonded }

Human-readable field variants. Will not be null when query param with_text is true.

total_bonded: string

value: object { extra, price, total_bonded }

USD values for the corresponding amounts above. Will not be null when query param with_value is true.

Note

This variant group contains an additional price field (set to the number used in value calculation).

The embedded text group will contain the text variant if with_text was specified as well.

extra: object { text }

text: object { price, total_bonded }

Human-readable variants of USD values. Will not be null when query params with_text and with_value are true.

price: string

Text representation of price

total_bonded: string

price: string

Price used in value calculations

total_bonded: string

total_bonded: string

The total amount staked to this pool

total_claimed: string

Total amount of NEPT claimed, either locked or unlocked

Includes initial balances and claimed rewards but not unclaimed rewards

total_issued: string

Total amount of NEPT issued, either locked or unlocked

Includes initial balances and all claimed or claimable rewards

total_locked: string

Total amount of NEPT locked

Inlcudes unlocks which have not yet been claimed

total_supply: string

Total supply of NEPT

Includes locked and unissued tokens

error: unknown

Error data. Guaranteed null for successful response.

status: number

HTTP status. Successful responses are guaranteed to be < 400. Conversely, error responses are guaranteed to be >= 400.

formatuint16

minimum0

maximum65535

status_text: string

HTTP status text

Get NEPT token state

HTTP

HTTP

TypeScript

Python

curl https://api-v2.nept.finance/api/v1/nept/state

200 example

500 example

{
  "data": {
    "total_issued": "8827797509",
    "total_claimed": "6457310435",
    "total_locked": "7952554397",
    "total_supply": "7166232925",
    "staking": [
      {
        "index": 0,
        "duration": 604800,
        "extra": {
          "text": {
            "duration": "7 days",
            "index": "1"
          }
        },
        "state": {
          "total_bonded": "0",
          "extra": {
            "text": {
              "total_bonded": "0.00000 NEPT"
            },
            "value": {
              "price": "0.032585758453916404",
              "total_bonded": "0",
              "extra": {
                "text": {
                  "price": "$0.03",
                  "total_bonded": "$0.00"
                }
              }
            }
          }
        }
      },
      {
        "index": 1,
        "duration": 2592000,
        "extra": {
          "text": {
            "duration": "30 days",
            "index": "2"
          }
        },
        "state": {
          "total_bonded": "0",
          "extra": {
            "text": {
              "total_bonded": "0.00000 NEPT"
            },
            "value": {
              "price": "0.032585758453916404",
              "total_bonded": "0",
              "extra": {
                "text": {
                  "price": "$0.03",
                  "total_bonded": "$0.00"
                }
              }
            }
          }
        }
      },
      {
        "index": 2,
        "duration": 7776000,
        "extra": {
          "text": {
            "duration": "90 days",
            "index": "3"
          }
        },
        "state": {
          "total_bonded": "0",
          "extra": {
            "text": {
              "total_bonded": "0.00000 NEPT"
            },
            "value": {
              "price": "0.032585758453916404",
              "total_bonded": "0",
              "extra": {
                "text": {
                  "price": "$0.03",
                  "total_bonded": "$0.00"
                }
              }
            }
          }
        }
      }
    ],
    "extra": {
      "text": {
        "total_issued": "8,827.79750 NEPT",
        "total_claimed": "6,457.31043 NEPT",
        "total_supply": "7,166.23292 NEPT",
        "total_locked": "7,952.55439 NEPT"
      },
      "value": {
        "total_supply": "233.517135118552829542",
        "price": "0.032585758453916404",
        "total_issued": "287.660477308358922525",
        "total_claimed": "210.416358096863862166",
        "total_locked": "259.1400166722728205",
        "extra": {
          "text": {
            "total_claimed": "$210.41",
            "total_locked": "$259.14",
            "total_supply": "$233.51",
            "total_issued": "$287.66",
            "price": "$0.03"
          }
        }
      }
    }
  },
  "error": null,
  "status": 200,
  "status_text": "OK"
}

{
  "data": null,
  "error": {
    "kind": "internal",
    "scope": "server",
    "message": "An unexpected error occurred"
  },
  "status": 500,
  "status_text": "Internal Server Error"
}

Returns Examples

200 example

500 example

{
  "data": {
    "total_issued": "8827797509",
    "total_claimed": "6457310435",
    "total_locked": "7952554397",
    "total_supply": "7166232925",
    "staking": [
      {
        "index": 0,
        "duration": 604800,
        "extra": {
          "text": {
            "duration": "7 days",
            "index": "1"
          }
        },
        "state": {
          "total_bonded": "0",
          "extra": {
            "text": {
              "total_bonded": "0.00000 NEPT"
            },
            "value": {
              "price": "0.032585758453916404",
              "total_bonded": "0",
              "extra": {
                "text": {
                  "price": "$0.03",
                  "total_bonded": "$0.00"
                }
              }
            }
          }
        }
      },
      {
        "index": 1,
        "duration": 2592000,
        "extra": {
          "text": {
            "duration": "30 days",
            "index": "2"
          }
        },
        "state": {
          "total_bonded": "0",
          "extra": {
            "text": {
              "total_bonded": "0.00000 NEPT"
            },
            "value": {
              "price": "0.032585758453916404",
              "total_bonded": "0",
              "extra": {
                "text": {
                  "price": "$0.03",
                  "total_bonded": "$0.00"
                }
              }
            }
          }
        }
      },
      {
        "index": 2,
        "duration": 7776000,
        "extra": {
          "text": {
            "duration": "90 days",
            "index": "3"
          }
        },
        "state": {
          "total_bonded": "0",
          "extra": {
            "text": {
              "total_bonded": "0.00000 NEPT"
            },
            "value": {
              "price": "0.032585758453916404",
              "total_bonded": "0",
              "extra": {
                "text": {
                  "price": "$0.03",
                  "total_bonded": "$0.00"
                }
              }
            }
          }
        }
      }
    ],
    "extra": {
      "text": {
        "total_issued": "8,827.79750 NEPT",
        "total_claimed": "6,457.31043 NEPT",
        "total_supply": "7,166.23292 NEPT",
        "total_locked": "7,952.55439 NEPT"
      },
      "value": {
        "total_supply": "233.517135118552829542",
        "price": "0.032585758453916404",
        "total_issued": "287.660477308358922525",
        "total_claimed": "210.416358096863862166",
        "total_locked": "259.1400166722728205",
        "extra": {
          "text": {
            "total_claimed": "$210.41",
            "total_locked": "$259.14",
            "total_supply": "$233.51",
            "total_issued": "$287.66",
            "price": "$0.03"
          }
        }
      }
    }
  },
  "error": null,
  "status": 200,
  "status_text": "OK"
}

{
  "data": null,
  "error": {
    "kind": "internal",
    "scope": "server",
    "message": "An unexpected error occurred"
  },
  "status": 500,
  "status_text": "Internal Server Error"
}