> ## Documentation Index > Fetch the complete documentation index at: https://blockscout-ap-optimize-logs-envs.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # List addresses holding native coins sorted by balance - top accounts > Retrieves a paginated list of addresses holding the native coin, sorted by balance. ## OpenAPI ````yaml /openapi-specs/pro-api-v12.json get /{chain_id}/api/v2/addresses openapi: 3.0.0 info: contact: email: info@blockscout.com url: https://dev.blockscout.com/ description: >- Blockscout's universal multichain API for accessing explorer-indexed blockchain data - such as addresses, transactions, blocks, tokens, NFTs, contracts, and related search/results endpoints - across supported networks through a single standardized interface. title: Blockscout Pro API version: 0.5.0 servers: - url: https://api.blockscout.com security: - bearerAuth: [] - apiKeyAuth: [] paths: /{chain_id}/api/v2/addresses: get: tags: - addresses summary: List addresses holding native coins sorted by balance - top accounts description: >- Retrieves a paginated list of addresses holding the native coin, sorted by balance. operationId: BlockScoutWeb.API.V2.AddressController.addresses_list parameters: - description: | Sort results by: * balance - Sort by account balance * transactions_count - Sort by number of transactions Should be used together with `order` parameter. in: query name: sort schema: enum: - balance - transactions_count type: string - description: | Sort order: * asc - Ascending order * desc - Descending order Should be used together with `sort` parameter. in: query name: order schema: enum: - asc - desc type: string - description: Number of items per page in: query name: items_count schema: minimum: 1 type: integer - description: Fetched coin balance for paging in: query name: fetched_coin_balance schema: $ref: '#/components/schemas/IntegerStringNullable' - description: Address hash for paging in: query name: hash schema: $ref: '#/components/schemas/AddressHash' - description: Transactions count for paging in: query name: transactions_count schema: anyOf: - type: integer - $ref: '#/components/schemas/EmptyString' - $ref: '#/components/schemas/NullString' - description: The ID of the blockchain in: path name: chain_id required: true schema: type: string responses: '200': content: application/json: schema: additionalProperties: false properties: exchange_rate: $ref: '#/components/schemas/FloatStringNullable' items: items: additionalProperties: false description: Address properties: coin_balance: $ref: '#/components/schemas/IntegerStringNullable' ens_domain_name: description: ENS domain name associated with the address nullable: true type: string hash: $ref: '#/components/schemas/AddressHash' implementations: description: Implementations linked with the contract items: $ref: '#/components/schemas/Implementation' type: array is_contract: description: Has address contract code? nullable: true type: boolean is_scam: description: Has address scam badge? type: boolean is_verified: description: Has address associated source code? nullable: true type: boolean metadata: allOf: - $ref: '#/components/schemas/Metadata' nullable: true name: description: Name associated with the address nullable: true type: string private_tags: description: Private tags associated with the address items: $ref: '#/components/schemas/Tag' type: array proxy_type: $ref: '#/components/schemas/ProxyType' public_tags: description: Public tags associated with the address items: $ref: '#/components/schemas/Tag' type: array reputation: description: Reputation of the address enum: - ok - scam type: string transactions_count: anyOf: - $ref: '#/components/schemas/IntegerString' - $ref: '#/components/schemas/EmptyString' nullable: true watchlist_names: description: Watchlist name associated with the address items: $ref: '#/components/schemas/WatchlistName' type: array required: - hash - is_contract - name - is_scam - reputation - proxy_type - implementations - is_verified - ens_domain_name - metadata - coin_balance - transactions_count title: Address type: object type: array next_page_params: example: fetched_coin_balance: '124355417998347240251800' hash: '0x59708733fbbf64378d9293ec56b977c011a08fd2' transactions_count: null nullable: true type: object total_supply: $ref: '#/components/schemas/FloatStringNullable' required: - items - next_page_params - exchange_rate - total_supply type: object description: List of native coin holders with their balances, with pagination. headers: x-credits-remaining: description: >- Number of credits remaining in your plan. Resets daily on the free plan, monthly otherwise. schema: type: integer x-ratelimit-limit: description: >- Available requests per second with your plan. Returns -1 on internal error. schema: type: integer x-ratelimit-remaining: description: >- Remaining rate limit based on your queries. Returns -1 on internal error. schema: type: integer x-ratelimit-reset: description: >- Time in milliseconds until the rate limit resets. Returns -1 on internal error. schema: type: integer '403': content: application/json: schema: $ref: '#/components/schemas/ForbiddenResponse' description: Forbidden components: schemas: IntegerStringNullable: nullable: true pattern: ^-?([1-9][0-9]*|0)$ title: IntegerStringNullable type: string AddressHash: pattern: ^0x([A-Fa-f0-9]{40})$ title: AddressHash type: string EmptyString: maxLength: 0 minLength: 0 title: EmptyString type: string NullString: pattern: ^null$ title: NullString type: string FloatStringNullable: nullable: true pattern: ^([1-9][0-9]*|0)(\.[0-9]+)?$ title: FloatStringNullable type: string Implementation: additionalProperties: false description: Proxy smart contract implementation properties: address_hash: $ref: '#/components/schemas/AddressHash' name: nullable: true type: string required: - address_hash - name title: Implementation type: object Metadata: additionalProperties: false description: Metadata struct properties: tags: description: Metadata tags linked with the address items: $ref: '#/components/schemas/MetadataTag' type: array required: - tags title: Metadata type: object Tag: additionalProperties: false description: Address tag struct properties: address_hash: $ref: '#/components/schemas/AddressHash' display_name: type: string label: type: string required: - address_hash - display_name - label title: Tag type: object ProxyType: enum: - eip1167 - eip1967 - eip1822 - eip1967_oz - eip1967_beacon - master_copy - basic_implementation - basic_get_implementation - comptroller - eip2535 - clone_with_immutable_arguments - eip7702 - resolved_delegate_proxy - erc7760 - minimal_proxy nullable: true title: ProxyType type: string IntegerString: pattern: ^-?([1-9][0-9]*|0)$ title: IntegerString type: string WatchlistName: additionalProperties: false description: Watchlist name struct properties: display_name: type: string label: type: string required: - display_name - label title: WatchlistName type: object ForbiddenResponse: description: Response returned when the user is forbidden to access the resource properties: message: description: >- Error message indicating the user is forbidden to access the resource example: Unverified email type: string title: ForbiddenResponse type: object MetadataTag: additionalProperties: false description: Metadata tag struct properties: meta: type: object name: type: string ordinal: type: integer slug: type: string tagType: type: string required: - slug - name - tagType - ordinal - meta title: MetadataTag type: object securitySchemes: bearerAuth: bearerFormat: JWT description: API key passed as a Bearer token in the Authorization header. scheme: bearer type: http apiKeyAuth: description: API key passed as the `apikey` query parameter. in: query name: apikey type: apiKey ````