# Wallet API

{% hint style="warning" %}
In Q1 2025, the Chiliz team will decommission several endpoints and features. This is to ensure that the Socios.com API remains focused on the Socios.com app features, and to bring it always closer to the Web3 ecosystem. 

Don't worry! We will provide you with alternatives right here on this documentation site.

You will find more information [in this guide](https://connect.socios.com/partner-api/2025-api-update-overview), and in each API section of this site.
{% endhint %}

{% hint style="danger" %}
**Wallet API endpoints that are decommissioned with alternatives**

The following endpoints will soon not be available anymore, and we encourage you to use one of the alternative we suggest here:

* `GET /user/wallet`:  Get wallet data for currently logged-in user.
* `GET /user/wallet/{transactionId}`: Get the transactions of a user wallet.
* `GET /user/wallet/transaction-history/fan-token:` Get the transaction history of a user wallet
* `POST /admin/wallet/transfer/fan-token`: Transfer Fan Tokens.

**Polls API endpoints that are decommissioned with no alternative**

The following endpoints cannot be easily replaced by an alternative:

* `POST /wallet/sign-message`: 

Sadly, if you do rely on one of these, you will have to remove the feature from your service.
{% endhint %}

## Socios.com Wallet API

The Wallet API aims to provide all information related to the wallet of the logged-in user, starting with how many Chiliz she/he owns.

In addition, you can use the Wallet API to redeem vouchers.

## Using the Wallet API

{% hint style="info" %}
If you're a new user and do not have access to the Socios.com portal yet, see [prerequisites](https://connect.socios.com/partner-api/prerequisites "mention").
{% endhint %}

1. Once you've logged in to the Socios.com API portal, select **Wallet**.
2. Click the **Try Out** button next to the API URL.
3. You'll see the following modal, indicating registering steps completed. \
   Click the **Try Out** button.\
   ![](https://31329255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMDcaoJLMj5Y3jzFMTONF%2Fuploads%2Fj7bKjj3regE9xlO92lQZ%2Fimage.png?alt=media\&token=c2bb9bc0-c982-4e55-b491-5429875b2e6a)
4. On the **Security** page that is now displayed, *OAuth* is already selected. Click on the **Get Test Key** button. 
5. Once the test key is generated, you can display it using the <img src="https://31329255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMDcaoJLMj5Y3jzFMTONF%2Fuploads%2FbOs5V6HzE1FDsxyfYUCh%2Fimage.png?alt=media&#x26;token=a58c5a36-10b0-499b-ad64-11eda7c15914" alt="" data-size="line"> icon.&#x20;

## Subscription

1. On the **Subscriptions** page then click on the **SUBSCRIPTION & KEY GENERATION WIZARD** button.
2. Then, enter valid details in the **Create application** form fields:<br>

   <table><thead><tr><th width="374">Parameter</th><th>Description</th></tr></thead><tbody><tr><td>Application Name</td><td>A valid name of the application</td></tr><tr><td>Shared Quota for Application Tokens</td><td>The amount of tokens generated for each application</td></tr><tr><td>Application Description </td><td>(Optional). A brief description about the application</td></tr></tbody></table>
3. In the *Subscribe to new application* step, enter the **Application** name you want to use. \
   Select a *Business Plan* from the dropdown menu, and click **Next.**
4. On the *Generate Keys* tab, once you've carefully reviewed the page, select **NEXT**.
5. On the *Generate Access Token* tab, enter a valid description in the **Scopes** field. Select **NEXT**.
6. On the *Copy Access Token* tab, select ![](https://31329255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMDcaoJLMj5Y3jzFMTONF%2Fuploads%2FkQq2AwEL1rl07fIDExOF%2Fimage.png?alt=media\&token=773d6678-8f8a-4877-9c4b-90f6c426ffb5) to copy the Access Token. Once copied, click **FINISH.**
7. You can view your newly created subscription under the **Subscriptions** section.

## Live example

See how [FanMarketCap](https://www.fanmarketcap.com/) uses the Wallet API to retrieve and display all the tokens in a user's wallet, along with NFTs:

<figure><img src="https://31329255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMDcaoJLMj5Y3jzFMTONF%2Fuploads%2FvFDVRPc61KX068lJKyS0%2FFanMarketCap_sample.jpg?alt=media&#x26;token=fe0e8427-1044-4014-8cd8-95ef5f1ade6b" alt=""><figcaption></figcaption></figure>

You can create a FanMarketCap account for free, to see how it behaves with your one Socios.com account!