> ## 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. # Get a List of Transactions by Address > Returns up to a maximum of 10,000 transactions for a given address. Also available through a GraphQL 'address' query. ## OpenAPI ````yaml /openapi-specs/jsonrpc-endpoints.yaml get /?module=account&action=txlist openapi: 3.1.0 info: title: Blockscout RPC API version: 1.0.0 description: > Blockscout is an open-source blockchain explorer for Ethereum-based networks. This API is provided for developers transitioning applications from Etherscan to Blockscout and applications requiring general API and data support. It supports GET and POST requests. ## Authentication **API keys are OPTIONAL** for all RPC endpoints. The API works without authentication but has different rate limits: - **Without API key:** 5 requests per second (shared pool across all users) - **With API key:** 10 requests per second per key (dedicated limit) - **Free tier:** Up to 3 API keys per account at no cost To use an API key, add `apikey=YOUR_API_KEY` to the query string: ``` https://eth.blockscout.com/api?module=account&action=balance&address=0x123...&apikey=YOUR_API_KEY ``` ## Base URL Format URLs vary by instance. With typical installations, access the API by adding `/api` to the end of the instance URL. **Example:** `https://eth-sepolia.blockscout.com/api` ## Query Format ### RPC API (Module/Action format) An example query includes a module and action(s)/parameters: ``` https://eth-sepolia.blockscout.com/api?module=account&action=balance&address=0x123... ``` ### ETH RPC API (JSON-RPC format) Standard Ethereum JSON-RPC methods use POST requests to `/api/eth-rpc`: ``` POST https://eth.blockscout.com/api/eth-rpc Content-Type: application/json {"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1} ``` Note: API keys can also be used with ETH RPC endpoints by adding `?apikey=YOUR_API_KEY` to the URL. license: name: MIT url: https://opensource.org/licenses/MIT contact: name: Blockscout Community url: https://discord.gg/blockscout servers: - url: https://eth.blockscout.com/api description: Ethereum Mainnet Explorer (RPC API) - url: https://eth-sepolia.blockscout.com/api description: Ethereum Sepolia Testnet Explorer (RPC API) - url: https://base.blockscout.com/api description: Base Mainnet Explorer (RPC API) - url: https://optimism.blockscout.com/api description: Optimism Mainnet Explorer (RPC API) - url: https://gnosis.blockscout.com/api description: Gnosis Chain Explorer (RPC API) security: - {} tags: - name: Account description: Account-related endpoints - name: Block description: Block-related endpoints - name: Contract description: Smart contract-related endpoints - name: Logs description: Event logs endpoints - name: Stats description: Network statistics endpoints - name: Token description: Token-related endpoints - name: Transaction description: Transaction-related endpoints - name: ETH RPC description: Ethereum JSON-RPC compatible endpoints externalDocs: url: https://docs.blockscout.com/devs/apis/rpc paths: /?module=account&action=txlist: get: tags: - Account summary: Get a List of Transactions by Address description: | Returns up to a maximum of 10,000 transactions for a given address. Also available through a GraphQL 'address' query. operationId: get-transactions-by-address parameters: - $ref: '#/components/parameters/module_account' - $ref: '#/components/parameters/action_txlist' - in: query name: address schema: $ref: '#/components/schemas/AddressHash' required: true description: Address hash - $ref: '#/components/parameters/startblock' - $ref: '#/components/parameters/endblock' - $ref: '#/components/parameters/page' - $ref: '#/components/parameters/offset' - $ref: '#/components/parameters/sort' - in: query name: filterby schema: type: string enum: - to - from required: false description: Filter transactions by direction responses: '200': description: Transaction list retrieved successfully content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - type: object properties: result: type: array items: $ref: '#/components/schemas/Transaction' - $ref: '#/components/schemas/ResponseNOTOK' externalDocs: url: https://docs.blockscout.com/devs/apis/rpc/account components: parameters: module_account: name: module in: query required: true schema: type: string enum: - account description: Module name (must be 'account') action_txlist: name: action in: query required: true schema: type: string enum: - txlist startblock: name: startblock in: query required: false schema: type: integer description: Starting block number endblock: name: endblock in: query required: false schema: type: integer description: Ending block number page: name: page in: query required: false schema: type: integer minimum: 1 default: 1 description: Page number for pagination offset: name: offset in: query required: false schema: type: integer minimum: 1 maximum: 10000 default: 10 description: Number of records to return per page (max 10000) sort: name: sort in: query required: false schema: type: string enum: - asc - desc default: desc description: Sort order (asc or desc) schemas: AddressHash: type: string pattern: ^0x[a-fA-F0-9]{40}$ example: '0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae' description: 40-character hexadecimal address hash with 0x prefix ResponseOK: type: object properties: status: type: string enum: - '1' description: Status code (1 = OK) message: type: string example: OK description: Response message Transaction: type: object properties: blockNumber: type: string timeStamp: type: string hash: $ref: '#/components/schemas/TransactionHash' nonce: type: string blockHash: type: string transactionIndex: type: string from: $ref: '#/components/schemas/AddressHash' to: $ref: '#/components/schemas/AddressHash' value: type: string description: Value in wei gas: type: string gasPrice: type: string isError: type: string enum: - '0' - '1' txreceipt_status: type: string enum: - '0' - '1' input: type: string contractAddress: $ref: '#/components/schemas/AddressHash' cumulativeGasUsed: type: string gasUsed: type: string confirmations: type: string ResponseNOTOK: type: object properties: status: type: string enum: - '0' description: Status code (0 = Error) message: type: string example: NOTOK description: Error message result: type: string nullable: true description: Error details TransactionHash: type: string pattern: ^0x[a-fA-F0-9]{64}$ example: '0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef' description: 64-character hexadecimal transaction hash with 0x prefix ````