# NFT & Token API

### Overview

\
The RapidChain API is an interface used to retrieve information about crypto asset tokens and perform transactions. This API can be used to obtain token details, token holders, as well as query the current token balances of specific users.

\
**API Endpoint**

All API calls should start with the following base URL:

[`https://api.rapidchain.io`\
](https://api.rapidchain.io)

**API Usage**

1\. Get Token Information

To retrieve token information, use the `/getTokens` endpoint.

* **HTTP Method:** GET
* **Endpoint:** `/getTokens`
*   **Example Usage:**

    ```bash
    curl -X GET https://api.rapidchain.io/getTokens
    ```

#### 2. Get Token Holders

To get the holders of a specific token, use the `/getTokenHolders` endpoint.

* **HTTP Method:** GET
* **Endpoint:** `/getTokenHolders?token_contract={token_contract}`
* **Parameters:**
  * `token_contract`: Token address&#x20;
*   **Example Usage:**

    ```bash
    curl -X GET "https://api.rapidchain.io/getTokenHolders?token_contract=123456789abcdef"
    ```

#### 3. Get Current Token Balance by Token Address

To retrieve the current balance of a specific user for a specific token, use the `/getCurrentTokenBalanceByTokenAddress` endpoint.

* **HTTP Method:** GET
* **Endpoint:** `/getCurrentTokenBalanceByTokenAddress?owner_address={owner_address}&token_contract={token_contract}`
* **Parameters:**
  * `owner_address`: User's address
  * `token_contract`: Token address&#x20;
*   **Example Usage:**

    ```bash
    curl -X GET "https://api.rapidchain.io/getCurrentTokenBalanceByTokenAddress?owner_address=abcdef123456&token_contract=123456789abcdef"
    ```

#### 4. Get All Token Balances

To retrieve all token balances of a specific user, use the `/getCurrentTokenBalance` endpoint.

* **HTTP Method:** GET
* **Endpoint:** `/getCurrentTokenBalance?owner_address={owner_address}`
* **Parameters:**
  * `owner_address`: User's address&#x20;
*   **Example Usage:**

    ```bash
    curl -X GET "https://api.rapidchain.io/getCurrentTokenBalance?owner_address=abcdef123456"
    ```

***

You can use the API calls mentioned above to utilize the RapidChain API. If you have any questions, please contact us at [support@rapidchain.io](mailto:support@rapidchain.io).\
\
