> ## Documentation Index > Fetch the complete documentation index at: https://docs.beaconcha.in/llms.txt > Use this file to discover all available pages before exploring further. # Latest consensus and execution state > Retrieve the latest known network state as observed by the explorer backend. The payload includes current slot and epoch numbers, the most recent finalized epoch, a finality delay indicator, a syncing flag, and display rates used for price conversions in the UI. ## OpenAPI ````yaml /api/v1/bundled.yaml get /api/v1/latestState openapi: 3.0.4 info: title: beaconcha.in API Documentation license: name: GPL-3.0 url: https://www.gnu.org/licenses/gpl-3.0.en.html description: >- > ⚠️ No new features or endpoints will be added to V1. We recommend the [V2 API](/api/overview) for all new projects. See the [migration guide](/api/v1-to-v2-migration). ## Introduction **Advanced and reliable API for accessing comprehensive Ethereum blockchain data.** - **Free Usage Policy:** The API is free to use under a fair use policy, with rate limits of 10 requests per minute per IP. - **Caching:** All responses are cached for 1 minute. - **Higher Usage Plans:** For higher usage plans, visit: [https://beaconcha.in/pricing](https://beaconcha.in/pricing). An API key is required to use these plans. ### API Key Usage API keys can be obtained at [/user/settings](https://beaconcha.in/user/settings) and must be included in requests either as a query string parameter or in the request header. #### Example: Query String Parameter ```bash curl https://beaconcha.in/api/v1/slot/1?apikey= ``` #### Example: Request Header ```bash curl -H 'apikey: ' https://beaconcha.in/api/v1/slot/1 ``` contact: {} version: '1.1' servers: - url: https://beaconcha.in description: Ethereum mainnet - url: https://hoodi.beaconcha.in description: Hoodi Ethereum testnet security: - ApiKeyAuthQuery: [] - ApiKeyAuthHeader: [] tags: - name: Epoch description: Data related to consensus layer epochs - name: Slots description: Data related to consensus layer slots - name: Validators description: Data related to consensus layer validators - name: Rewards description: Data related to validator rewards - name: Sync Committees description: Data related to sync committees - name: Rocketpool description: Data related to the rocketpool protocol - name: ETH.Store® description: Data related to the ETH.Store® metric - name: Validator deposits description: Data related to execution layer validator deposits - name: Blocks description: Data related to execution layer blocks - name: Gas description: Data related to gas prices - name: Address description: Data related to ethereum addresses - name: Network description: Network data - name: Misc description: Miscellaneous data - name: User description: User data - name: Machine Metrics description: Submit machine, beacon-node, and validator-client monitoring metrics paths: /api/v1/latestState: get: tags: - Network summary: Latest consensus and execution state description: >- Retrieve the latest known network state as observed by the explorer backend. The payload includes current slot and epoch numbers, the most recent finalized epoch, a finality delay indicator, a syncing flag, and display rates used for price conversions in the UI. operationId: getLatestState responses: '200': description: >- Latest state was retrieved successfully. The `data` object contains the current chain status and pricing context. content: application/json: schema: allOf: - $ref: '#/components/schemas/types.ApiResponse' - type: object properties: data: $ref: '#/components/schemas/types.LatestState' '400': description: The request is invalid. content: application/json: schema: $ref: '#/components/schemas/types.ApiErrorResponse' examples: invalidRequest: summary: Invalid request value: status: 'ERROR: invalid request' data: null '500': description: An unexpected server error occurred while processing your request. content: application/json: schema: $ref: '#/components/schemas/types.ApiErrorResponse' examples: serverError: summary: Internal error value: status: 'ERROR: internal server error' data: null components: schemas: types.ApiResponse: type: object description: Standard success envelope used by all API endpoints. properties: status: type: string description: >- HTTP-independent status of the API operation. For successful responses this is always "OK". enum: - OK data: description: Response payload specific to the endpoint. nullable: true x-omitempty: true types.LatestState: type: object description: >- Snapshot of the latest beacon chain state along with pricing metadata used by the UI. properties: lastProposedSlot: type: integer description: >- Highest slot number for which a block proposal has been observed and indexed. minimum: 0 example: 12771116 currentSlot: type: integer description: >- Latest processed slot number based on chain time as observed by the backend. minimum: 0 example: 12771115 currentEpoch: type: integer description: Epoch number corresponding to the current slot. minimum: 0 example: 399097 currentFinalizedEpoch: type: integer description: Most recent epoch that has been finalized by the consensus protocol. minimum: 0 example: 399094 finalityDelay: type: integer description: >- Number of epochs between the current epoch and the latest finalized epoch (currentEpoch - currentFinalizedEpoch). Always non-negative. minimum: 0 example: 3 syncing: type: boolean description: >- Indicates whether the backend is still catching up to the network head. When true, some values may lag behind real time. example: false rates: $ref: '#/components/schemas/types.Rates' description: >- Currency settings and price data used for value conversions in the UI. types.ApiErrorResponse: type: object description: Standard error envelope returned when a request fails. properties: status: type: string description: >- Human-readable error indicator and message. The value begins with "ERROR:" followed by details. example: 'ERROR: ' data: type: string description: Optional additional context for the error. Null in most cases. nullable: true default: null types.Rates: type: object description: >- Currency and price metadata used by the UI to display values and perform conversions. properties: tickerCurrency: type: string description: >- Fiat currency code used for the price ticker (ISO 4217 code, e.g., USD, EUR). example: USD tickerCurrencySymbol: type: string description: Symbol of the ticker fiat currency. example: $ selectedCurrency: type: string description: Primary asset selected for display in the UI (usually ETH). example: ETH selectedCurrencySymbol: type: string description: Symbol used for the selected currency. example: ETH mainCurrency: type: string description: >- Primary asset used for conversions and price displays (same as selectedCurrency in most deployments). example: ETH mainCurrencySymbol: type: string description: Symbol used for the primary asset. example: ETH mainCurrencyPrice: type: number description: >- Conversion rate of the primary asset to itself. This is 1 when mainCurrency equals the base asset (ETH). example: 1 mainCurrencyPriceFormatted: type: string description: >- Formatted string representation of mainCurrencyPrice for UI display (may include separators or HTML markup). example: '1' mainCurrencyKFormatted: type: string description: >- Abbreviated (thousands) representation of mainCurrencyPrice for compact displays. example: '1' mainCurrencyTickerPrice: type: number description: Spot price of the primary asset in the ticker fiat currency. example: 4366.60356702 mainCurrencyTickerPriceFormatted: type: string description: >- Formatted string representation of mainCurrencyTickerPrice for UI display (may include thousands separators or HTML markup). example: 4366 mainCurrencyTickerPriceKFormatted: type: string description: >- Abbreviated (thousands) representation of mainCurrencyTickerPrice for compact displays. example: 4366 elCurrency: type: string description: >- Asset used when displaying values originating from the execution layer (typically ETH). example: ETH elCurrencySymbol: type: string description: Symbol used for the execution-layer asset. example: ETH elCurrencyPrice: type: number description: >- Conversion rate of the execution-layer asset to itself. This is 1 when elCurrency equals ETH. example: 1 elCurrencyPriceFormatted: type: string description: Formatted string representation of elCurrencyPrice. example: '1' elCurrencyKFormatted: type: string description: Abbreviated (thousands) representation of elCurrencyPrice. example: '1' clCurrency: type: string description: >- Asset used when displaying values originating from the consensus layer (typically ETH). example: ETH clCurrencySymbol: type: string description: Symbol used for the consensus-layer asset. example: ETH clCurrencyPrice: type: number description: >- Conversion rate of the consensus-layer asset to itself. This is 1 when clCurrency equals ETH. example: 1 clCurrencyPriceFormatted: type: string description: Formatted string representation of clCurrencyPrice. example: '1' clCurrencyKFormatted: type: string description: Abbreviated (thousands) representation of clCurrencyPrice. example: '1' mainCurrencyTickerPrices: type: object description: >- Map of fiat currency codes to compact price representations for the primary asset. additionalProperties: $ref: '#/components/schemas/types.RatesPrice' types.RatesPrice: type: object description: >- Compact price representation used in UI tickers for a specific fiat currency. properties: symbol: type: string description: Fiat currency symbol corresponding to the price (e.g., $, €). example: $ roundPrice: type: integer description: Price rounded to the nearest integer amount in the fiat currency. example: 4366 truncPrice: type: string description: Abbreviated string representation (e.g., 4.3k) for compact displays. example: 4.3k securitySchemes: ApiKeyAuthQuery: type: apiKey in: query name: apikey description: '' ApiKeyAuthHeader: type: apiKey in: header name: apikey description: '' ````