Polls API

A Polls API Manager walkthrough

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, and in each API section of this site.

Polls API endpoints that are decommissioned with alternatives

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

• GET /polls: Get a list of polls using search filters.

• GET /user/poll/{pollId}/vote: Vote on a poll.

Polls API endpoints that are decommissioned with no alternative

The following endpoints cannot be easily replaced by an alternative:

• POST /user/polls: Get user polls with search filters.

• POST /user/poll/{pollId}: Get user response on a poll.

• POST /user/poll/{pollId}/vote: Get user response on a poll.

• POST/user/polls/history: Get user polls history.

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

Socios.com Polls API

The Polls API aims to provide a list of polls including individual details such as their questions, possible answers, starting dates, and end dates. You can enable your users to vote directly on your website if they hold fan tokens of the team related to that poll.

Using the Poll API

If you're a new user and do not have access to the Socios.com portal yet, see Prerequisites.

1. Once you've logged in to the Socios.com API portal, select Polls.

1. Click the Try Out button next to the API URL.

1. You'll see the following modal, indicating registering steps completed. Click the Try Out button.

1. On the Security page that is now displayed, OAuth is already selected. Click on the Get Test Key button.

1. Once the test key is generated, you can display it using the icon.

Subscription

1. On the Subscriptions page then click on the SUBSCRIPTION & KEY GENERATION WIZARD button.

1. Then, enter valid details in the Create application form fields:

Parameter	Description
Application Name	A valid name of the Application
Shared Quota for Application Tokens	The amount of tokens generated for each application
Application Description	(Optional). A brief description about the application

1. 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.

1. On the Generate Keys tab, once you've carefully reviewed the page, select NEXT.

1. On the Generate Access Token tab, enter a valid description in the Scopes field. Select NEXT.

1. On the Copy Access Token tab, select to copy the Access Token. Once copied, click FINISH.

   

2. You can view your newly created Polls subscription under the Subscriptions section.