# Token Supply API

You can use the following endpoints to access supply data for DeFi Kingdoms [Ecosystem](/tokens/ecosystem-token.md) and [Power Tokens](/tokens/power-tokens.md).

#### All Token Supply

## Returns JSON supply data for JEWEL, CRYSTAL, and JADE

<mark style="color:blue;">`GET`</mark> `https://supply.defikingdoms.com/`

**Example**

<https://supply.defikingdoms.com/>

{% tabs %}
{% tab title="200: OK " %}

{% endtab %}

{% tab title="304: Not Modified " %}

{% endtab %}

{% tab title="500: Internal Server Error " %}

{% endtab %}
{% endtabs %}

#### Single Token Supply

## Returns JSON supply data for a specific token

<mark style="color:blue;">`GET`</mark> `https://supply.defikingdoms.com/{token}`

**Examples**

JEWEL - <https://supply.defikingdoms.com/jewel/>

CRYSTAL - <https://supply.defikingdoms.com/crystal/>

JADE - <https://supply.defikingdoms.com/jade/>

#### Path Parameters

| Name                                    | Type   | Description                                                                                                                   |
| --------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------- |
| token<mark style="color:red;">\*</mark> | string | <p>The string name of the requested token.</p><p></p><p>E.g.: <code>jewel</code>, <code>crystal</code>, <code>jade</code></p> |

{% tabs %}
{% tab title="200: OK " %}

{% endtab %}

{% tab title="304: Not Modified " %}

{% endtab %}

{% tab title="500: Internal Server Error " %}

{% endtab %}
{% endtabs %}

#### Single Token Total Supply

## Returns the Total Supply of a specific token in plain text

<mark style="color:blue;">`GET`</mark> `https://supply.defikingdoms.com/{token}/totalsupply`

**Examples**

JEWEL - [https://supply.defikingdoms.com/jewel/totalsupply](https://supply.defikingdoms.com/jewel/totalSupply)

CRYSTAL - [https://supply.defikingdoms.com/crystal/totalsupply](https://supply.defikingdoms.com/crystal/totalSupply)

JADE - [https://supply.defikingdoms.com/jade/totalsupply](https://supply.defikingdoms.com/jade/totalSupply)

#### Path Parameters

| Name                                    | Type   | Description                                                                                                                   |
| --------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------- |
| token<mark style="color:red;">\*</mark> | string | <p>The string name of the requested token.</p><p></p><p>E.g.: <code>jewel</code>, <code>crystal</code>, <code>jade</code></p> |

{% tabs %}
{% tab title="200: OK " %}

{% endtab %}

{% tab title="304: Not Modified " %}

{% endtab %}

{% tab title="500: Internal Server Error " %}

{% endtab %}
{% endtabs %}

#### Single Token Circulating Supply

## Returns the Circulating Supply of a specific token in plain text

<mark style="color:blue;">`GET`</mark> `https://supply.defikingdoms.com/{token}/circulatingsupply`

**Examples**

JEWEL - <https://supply.defikingdoms.com/jewel/circulatingsupply>

CRYSTAL - <https://supply.defikingdoms.com/crystal/circulatingsupply>

JADE - <https://supply.defikingdoms.com/jade/circulatingsupply>

#### Path Parameters

| Name                                    | Type   | Description                                                                                                                   |
| --------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------- |
| token<mark style="color:red;">\*</mark> | string | <p>The string name of the requested token.</p><p></p><p>E.g.: <code>jewel</code>, <code>crystal</code>, <code>jade</code></p> |

{% tabs %}
{% tab title="200: OK " %}

{% endtab %}

{% tab title="304: Not Modified " %}

{% endtab %}

{% tab title="500: Internal Server Error " %}

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://devs.defikingdoms.com/api/token-supply-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.