How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Polkadot

Polkadot accounts API

Account balance, staking, and proxy information

Documentation Provider Profile APIs.io OpenAPI GitHub

Polkadot accounts API is one of 57 APIs that Polkadot publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Account. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, rate-limit docs, and a GitHub repository.

This API exposes 24 operations across 24 paths, and defines 44 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against 6 base URLs: http://localhost:8080/v1, https://polkadot-public-sidecar.parity-chains.parity.io/, https://kusama-public-sidecar.parity-chains.parity.io/, https://polkadot-asset-hub-public-sidecar.parity-chains.parity.io/, https://kusama-asset-hub-public-sidecar.parity-chains.parity.io/, http://localhost:8080.

24 operations 24 paths 44 schemas 24 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://polkadot.api.subscan.io
Resource Areas
1

Paths & Operations 24

Across 24 paths, the API surfaces 24 operations — 24 GET. Each is listed below with its method, path, parameters, and response codes.

accounts 24

Account balance, staking, and proxy information

GET
/v1/accounts/compare
Compare account addresses
get_compare 1 param → 200400
GET
/v1/accounts/{accountId}/asset-approvals
Account asset approvals
get_asset_approvals 5 params → 200400500503
GET
/v1/accounts/{accountId}/asset-balances
Account asset balances
get_asset_balances 5 params → 200400500503
GET
/v1/accounts/{accountId}/balance-info
Account balance info
get_balance_info 5 params → 200400500503
GET
/v1/accounts/{accountId}/convert
Convert account format
get_convert 4 params → 200400500503
GET
/v1/accounts/{accountId}/foreign-asset-balances
Account foreign asset balances
get_foreign_asset_balances 5 params → 200400500503
GET
/v1/accounts/{accountId}/pool-asset-approvals
Account pool asset approvals
get_pool_asset_approvals 5 params → 200400500503
GET
/v1/accounts/{accountId}/pool-asset-balances
Account pool asset balances
get_pool_asset_balances 5 params → 200400500503
GET
/v1/accounts/{accountId}/proxy-info
Account proxy info
get_proxy_info 3 params → 200400500503
GET
/v1/accounts/{accountId}/staking-info
Account staking info
get_staking_info 4 params → 200400500503
GET
/v1/accounts/{accountId}/staking-payouts
Account staking payouts
get_staking_payouts 6 params → 200400500503
GET
/v1/accounts/{accountId}/validate
Validate account address
get_validate 2 params → 200
GET
/v1/accounts/{accountId}/vesting-info
Account vesting info
get_vesting_info 4 params → 200400500503
GET
/accounts/{accountId}/asset-balances
Get an array of asset-balances for an account.
getAssetBalances 5 params → 200400
GET
/accounts/{accountId}/asset-approvals
Get an asset approval for an account.
getAssetApprovals 6 params → 200400
GET
/accounts/{accountId}/balance-info
Get balance information for an account.
getAccountBalanceInfo 6 params → 200400404
GET
/accounts/{accountId}/convert
Convert a given AccountId to an SS58 address.
accountConvert 4 params → 200400404
GET
/accounts/{accountId}/pool-asset-balances
Get an array of pool-asset-balances for an account.
getPoolAssetBalances 5 params → 200400
GET
/accounts/{accountId}/pool-asset-approvals
Get an asset approval for an account.
getPoolAssetApprovals 6 params → 200400
GET
/accounts/{accountId}/foreign-asset-balances
Get an array of foreign-asset-balances for an account.
getForeignAssetBalances 5 params → 200400
GET
/accounts/{accountId}/proxy-info
Get proxy account information.
getProxyInfo 4 params → 200400
GET
/accounts/{accountId}/vesting-info
Get vesting information for an account.
getVestingSummaryByAccountId 5 params → 200400404
GET
/accounts/{address}/validate
Validate a given address.
getValidationByAccountId 1 param → 200
GET
/accounts/compare
Compares up to 30 SS58 addresses.
accountCompare 1 param → 200400

Schemas 44

The contract defines 44 schemas that model the data the API accepts and returns. The most detailed are AccountBalanceInfo (13 properties), BalanceInfoResponse (13 properties), AccountVestingInfo (10 properties), StakingInfoResponse (9 properties). Each schema is shown below with its type and property counts.

AssetBalancesResponse
object
Response for GET /accounts/{accountId}/asset-balances
5 properties 2 required
PoolAssetApprovalResponse
object
Response for GET /accounts/{accountId}/pool-asset-approvals
6 properties 1 required
AccountCompareResponse
object
Response for GET /accounts/compare
2 properties 2 required
VestingSchedule
object
A vesting schedule
3 properties 3 required
NominationsInfo
object
Nominations information for a nominator
3 properties 3 required
AddressDetails
object
Details about a single address
4 properties 1 required
VestingInfoResponse
object
Response for GET /accounts/{accountId}/vesting-info
5 properties 2 required
AssetBalance
object
Asset balance information
4 properties 4 required
EraPayouts
Payouts for a single era - can be either actual payouts or an error message
AccountValidateResponse
object
Response for GET /accounts/{accountId}/validate
4 properties 1 required
ProxyDefinition
object
A proxy definition containing the delegate, proxy type, and delay
3 properties 3 required
RewardDestination
Reward destination - e.g. { "staked": null }, { "stash": null }, { "account": "..." }
StakingLedger
object
Staking ledger information
5 properties 4 required
ValidatorPayout
object
Payout information for a single validator
7 properties 7 required
AssetApprovalResponse
object
Response for GET /accounts/{accountId}/asset-approvals
6 properties 1 required
ClaimedReward
object
Claimed reward status for a specific era
2 properties 2 required
StakingInfoResponse
object
Response for GET /accounts/{accountId}/staking-info
9 properties 5 required
PoolAssetBalancesResponse
object
Response for GET /accounts/{accountId}/pool-asset-balances
5 properties 2 required
StakingPayoutsResponse
object
Response for GET /accounts/{accountId}/staking-payouts
5 properties 2 required
ProxyInfoResponse
object
Response for GET /accounts/{accountId}/proxy-info
6 properties 3 required
AccountConvertResponse
object
Response for GET /accounts/{accountId}/convert
6 properties 6 required
EraPayoutsData
object
Actual payout data for an era
4 properties 4 required
PoolAssetBalance
object
Pool asset balance information
4 properties 4 required
BlockInfo
object
Block information
2 properties 2 required
UnlockingChunk
object
Unlocking chunk with value and era when funds become available
2 properties 2 required
BalanceInfoResponse
object
Response for GET /accounts/{accountId}/balance-info
13 properties 10 required
BalanceLock
object
Balance lock information
3 properties 3 required
AssetsBalance
object
4 properties
ForeignAssetBalance
object
4 properties
AddressDetails_2
object
4 properties
AccountPoolAssetsBalances
object
5 properties
AccountForeignAssetsBalances
object
5 properties
AccountAssetsApproval
object
6 properties
AccountConvert
object
6 properties
AccountValidation
object
4 properties
AccountBalanceInfo
object
13 properties
BlockIdentifiers
object
2 properties
AccountVestingInfo
object
Sidecar version's =11.0.0, that value will now default as an array when there is no value, and Vec is returned when there is.
10 properties
Error
object
4 properties
AccountAssetsBalances
object
5 properties
AccountCompare
object
2 properties
VestingSchedule_2
object
Vesting schedule for an account.
4 properties
BalanceLock_2
object
3 properties
AccountProxyInfo
object
6 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

polkadot-accounts-api-openapi.yml Raw ↑

Other APIs Polkadot publishes across the network.

Polkadot Account API
AE Profile APIs.io
Polkadot ahm API
AE Profile APIs.io
Polkadot Assets API
AE Profile APIs.io
Polkadot Avail API
AE Profile APIs.io
Polkadot Bifrost API
AE Profile APIs.io
Polkadot Block API
AE Profile APIs.io
Polkadot blocks API
AE Profile APIs.io
Polkadot capabilities API
AE Profile APIs.io
Polkadot Collator API
AE Profile APIs.io
Polkadot Common API
AE Profile APIs.io
Polkadot Contracts API
AE Profile APIs.io
Polkadot coretime API
AE Profile APIs.io
#Account
← Back to P APIs
API Details
ID
polkadot:polkadot-accounts-api
Base URL
https://polkadot.api.subscan.io
Docs
https://support.subscan.io/
Provider
Polkadot
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=polkadot-accounts-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/polkadot-accounts-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Polkadot accounts API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.