> ## Documentation Index > Fetch the complete documentation index at: https://docs.blockscout.com/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-v11.yaml get /v2/addresses openapi: 3.0.0 info: contact: email: info@blockscout.com title: Blockscout version: 11.0.3 servers: - url: http://localhost/api variables: {} security: [] tags: - name: blocks - name: transactions - name: addresses - name: internal-transactions - name: tokens - name: token-transfers - name: smart-contracts - name: config - name: main-page - name: search - name: stats - name: csv-export - name: account-abstraction - name: withdrawals - name: advanced-filters - name: arbitrum - name: legacy - name: optimism - name: mud - name: celo - name: scroll - name: zilliqa paths: /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: API key for rate limiting or for sensitive endpoints in: query name: apikey required: false schema: type: string x-struct: null x-validate: null - description: Secret key for getting access to restricted resources in: query name: key required: false schema: type: string x-struct: null x-validate: null - 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 required: false schema: enum: - balance - transactions_count type: string x-struct: null x-validate: null - description: | Sort order: * asc - Ascending order * desc - Descending order Should be used together with `sort` parameter. in: query name: order required: false schema: enum: - asc - desc type: string x-struct: null x-validate: null - description: Fetched coin balance for paging in: query name: fetched_coin_balance required: false schema: $ref: '#/components/schemas/IntegerStringNullable' - description: Address hash for paging in: query name: hash required: false schema: $ref: '#/components/schemas/AddressHash' - description: Number of items returned per page in: query name: items_count required: false schema: maximum: 50 minimum: 1 type: integer x-struct: null x-validate: null - description: Transactions count for paging in: query name: transactions_count required: false schema: anyOf: - type: integer x-struct: null x-validate: null - $ref: '#/components/schemas/EmptyString' - $ref: '#/components/schemas/NullString' x-struct: null x-validate: null responses: '200': content: application/json: schema: additionalProperties: false nullable: 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 x-struct: null x-validate: null hash: $ref: '#/components/schemas/AddressHash' implementations: description: Implementations linked with the contract items: $ref: '#/components/schemas/Implementation' type: array x-struct: null x-validate: null is_contract: description: Has address contract code? nullable: true type: boolean x-struct: null x-validate: null is_scam: description: Has address scam badge? nullable: false type: boolean x-struct: null x-validate: null is_verified: description: Has address associated source code? nullable: true type: boolean x-struct: null x-validate: null metadata: allOf: - $ref: '#/components/schemas/Metadata' nullable: true x-struct: null x-validate: null name: description: Name associated with the address nullable: true type: string x-struct: null x-validate: null private_tags: description: Private tags associated with the address items: $ref: '#/components/schemas/Tag' type: array x-struct: null x-validate: null proxy_type: $ref: '#/components/schemas/ProxyType' public_tags: description: Public tags associated with the address items: $ref: '#/components/schemas/Tag' type: array x-struct: null x-validate: null reputation: description: Reputation of the address enum: - ok - scam nullable: false type: string x-struct: null x-validate: null transactions_count: anyOf: - $ref: '#/components/schemas/IntegerString' - $ref: '#/components/schemas/EmptyString' nullable: true x-struct: null x-validate: null watchlist_names: description: Watchlist name associated with the address items: $ref: '#/components/schemas/WatchlistName' type: array x-struct: null x-validate: null 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 x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.Address x-validate: null nullable: false type: array x-struct: null x-validate: null next_page_params: example: fetched_coin_balance: '124355417998347240251800' hash: '0x59708733fbbf64378d9293ec56b977c011a08fd2' items_count: 50 transactions_count: null nullable: true type: object x-struct: null x-validate: null total_supply: $ref: '#/components/schemas/FloatStringNullable' required: - items - next_page_params - exchange_rate - total_supply type: object x-struct: null x-validate: null description: List of native coin holders with their balances, with pagination. '403': content: application/json: schema: $ref: '#/components/schemas/ForbiddenResponse' description: Forbidden callbacks: {} components: schemas: IntegerStringNullable: nullable: true pattern: ^-?([1-9][0-9]*|0)$ title: IntegerStringNullable type: string x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.IntegerStringNullable x-validate: null AddressHash: nullable: false pattern: ^0x([A-Fa-f0-9]{40})$ title: AddressHash type: string x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.AddressHash x-validate: null EmptyString: maxLength: 0 minLength: 0 title: EmptyString type: string x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.EmptyString x-validate: null NullString: pattern: ^null$ title: NullString type: string x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.NullString x-validate: null FloatStringNullable: nullable: true pattern: ^([1-9][0-9]*|0)(\.[0-9]+)?$ title: FloatStringNullable type: string x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.FloatStringNullable x-validate: null Implementation: additionalProperties: false description: Proxy smart contract implementation properties: address_hash: $ref: '#/components/schemas/AddressHash' name: nullable: true type: string x-struct: null x-validate: null required: - address_hash - name title: Implementation type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.Implementation x-validate: null Metadata: additionalProperties: false description: Metadata struct properties: tags: description: Metadata tags linked with the address items: $ref: '#/components/schemas/MetadataTag' type: array x-struct: null x-validate: null required: - tags title: Metadata type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.Proxy.Metadata x-validate: null Tag: additionalProperties: false description: Address tag struct properties: address_hash: $ref: '#/components/schemas/AddressHash' display_name: nullable: false type: string x-struct: null x-validate: null label: nullable: false type: string x-struct: null x-validate: null required: - address_hash - display_name - label title: Tag type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.Tag x-validate: null 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 nullable: true title: ProxyType type: string x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.ProxyType x-validate: null IntegerString: nullable: false pattern: ^-?([1-9][0-9]*|0)$ title: IntegerString type: string x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.IntegerString x-validate: null WatchlistName: additionalProperties: false description: Watchlist name struct properties: display_name: nullable: false type: string x-struct: null x-validate: null label: nullable: false type: string x-struct: null x-validate: null required: - display_name - label title: WatchlistName type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.WatchlistName x-validate: null 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 x-struct: null x-validate: null title: ForbiddenResponse type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.ErrorResponses.ForbiddenResponse x-validate: null MetadataTag: additionalProperties: false description: Metadata tag struct properties: meta: nullable: false type: object x-struct: null x-validate: null name: nullable: false type: string x-struct: null x-validate: null ordinal: nullable: false type: integer x-struct: null x-validate: null slug: nullable: false type: string x-struct: null x-validate: null tagType: nullable: false type: string x-struct: null x-validate: null required: - slug - name - tagType - ordinal - meta title: MetadataTag type: object x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.Proxy.MetadataTag x-validate: null ````