> ## Documentation Index > Fetch the complete documentation index at: https://ormilabs.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Get Events > Fetches a paginated list of smart contract event logs. Can be filtered by contract address and event signatures (topic0). ## OpenAPI ````yaml /open-api/0xapi.yaml get /v2/{chain_name}/events openapi: 3.0.0 info: description: >- API for accessing blockchain data including tokens, NFTs, transactions, events, ENS, and blocks. Authentication is optional; providing an API key via Bearer token may grant higher rate limits or access to additional features. title: Ormi Data API version: v2 servers: - url: https://api.data.ormilabs.com security: - OrmiApiKey: [] tags: - description: Operations related to fungible tokens and wallet balances. name: Tokens - description: Operations related to Non-Fungible Tokens (NFTs). name: NFTs - description: Operations related to blockchain transactions. name: Transactions - description: Operations related to smart contract events. name: Events - description: Operations related to blockchain blocks. name: Blocks paths: /v2/{chain_name}/events: get: tags: - Events summary: Get Events description: >- Fetches a paginated list of smart contract event logs. Can be filtered by contract address and event signatures (topic0). operationId: getEvents parameters: - $ref: '#/components/parameters/ContractAddressQueryParam' - description: > Comma-separated list of event signatures (topic0) to filter events by. Each item can be a 32-byte Keccak256 hash of the event signature (topic0), e.g.: `0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef` or a plain ABI event signature string, e.g.: `Transfer(address,address,uint256)` in: query name: signatures schema: example: - 1.0038928713678618e+77 - Transfer(address,address,uint256) items: type: string type: array - $ref: '#/components/parameters/WindowParameter' - description: Sort order for results. in: query name: sort_by schema: default: latest enum: - latest - earliest type: string - $ref: '#/components/parameters/LimitParameter' - $ref: '#/components/parameters/CursorParameter' - $ref: '#/components/parameters/ChainNameParameter' responses: '200': content: application/json: schema: $ref: '#/components/schemas/EventsResponse' description: Successfully retrieved events. '400': $ref: '#/components/responses/BadRequestError' '401': $ref: '#/components/responses/UnauthorizedError' '429': $ref: '#/components/responses/RateLimitError' '500': $ref: '#/components/responses/InternalServerError' components: parameters: ContractAddressQueryParam: allowEmptyValue: true description: Contract addresses to filter by. in: query name: contract_address schema: example: '0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D' pattern: ^0x[a-fA-F0-9]{40}$ type: string WindowParameter: description: | Specifies time or block range for the query. The format can be a relative duration like `30d` or `12h`. Or interval of time `2025-08-20T00:00:00Z..2025-08-26T12:00:00Z`. Or range of blocks `18000000..18000100`. examples: block_range: summary: Data between two block numbers value: 18000000..18000100 last_30_days: summary: Data from the last 30 days value: 30d open_ended_range: summary: Data from block 18,500,000 to latest value: 18500000.. time_range: summary: Data between two timestamps value: 2025-08-20T00:00:00Z..2025-08-26T12:00:00Z in: query name: window required: false schema: type: string LimitParameter: description: Maximum number of items to return. in: query name: limit schema: default: 50 maximum: 1000 minimum: 1 type: integer CursorParameter: description: Cursor for pagination to retrieve the next set of results. in: query name: cursor schema: type: string ChainNameParameter: description: The name or ID of the blockchain. in: path name: chain_name required: true schema: enum: - ethereum - apechain - arbitrum - avalanche - base - bsc - polygon example: ethereum type: string schemas: EventsResponse: allOf: - $ref: '#/components/schemas/PaginationBase' - properties: events: items: $ref: '#/components/schemas/EventItem' type: array required: - events type: object PaginationBase: properties: next_cursor: example: ICJkYXNkYXMifQ== type: string x-omitempty: false type: object EventItem: properties: block_number: example: 22412527 format: int64 type: integer block_timestamp: example: '2025-05-04T19:38:11Z' format: date-time type: string contract_address: example: '0x312e67b47a2a29ae200184949093d92369f80b53' pattern: ^0x[a-fA-F0-9]{40}$ type: string data: description: Raw data field of the log. example: 0x000... type: string log_index: example: 3213123 format: int64 type: integer topics: example: - 1.0038928713678618e+77 items: type: string type: array transaction_hash: example: '0x94ead602754fb7b4e6a884173ef9f68860e847a43788f5da13f7dbb4922e52ea' pattern: ^0x[a-fA-F0-9]{64}$ type: string transaction_index: example: 3213123 format: int64 type: integer required: - block_number - block_timestamp - contract_address - from_address - to_address - transaction_hash - transaction_index - log_index - topics - decoded - data - signature type: object ApiError: properties: code: description: Internal application-specific error code. example: 20001 type: integer data: additionalProperties: true description: Additional data related to the error, if applicable. example: {} type: object msg: description: A human-readable message providing more details about the error. example: Invalid API key provided. type: string required: - code - msg type: object responses: BadRequestError: content: application/json: examples: genericBadRequest: summary: Generic Bad Request value: code: 20101 data: {} msg: Bad request. Please check your input. missingData: summary: Missing data value: code: 20301 data: {} msg: Data missing. Please check your input. validationFailed: summary: Validation Failed value: code: 20201 data: errors: - field: email message: Email is not valid - field: age message: Age must be a positive number msg: Validation failed. Please check your input schema: $ref: '#/components/schemas/ApiError' description: >- Bad Request - The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing). UnauthorizedError: content: application/json: examples: invalidApiKey: summary: Invalid API Key value: code: 10005 data: {} msg: Invalid API key provided. missingApiKey: summary: Missing API Key value: code: 10003 data: {} msg: API key is missing from the Authorization header. schema: $ref: '#/components/schemas/ApiError' description: >- Unauthorized - The client request has not been completed because it lacks valid authentication credentials for the requested resource. Typically for an invalid or missing API key. RateLimitError: content: application/json: examples: rateLimited: summary: Rate Limit Exceeded value: code: 10020 data: retry_after_seconds: 60 msg: Rate limit exceeded. Please try again later. schema: $ref: '#/components/schemas/ApiError' description: >- Too Many Requests - The user has sent too many requests in a given amount of time ("rate limiting"). InternalServerError: content: application/json: examples: serverError: summary: Internal Server Error value: code: 20901 data: {} msg: An unexpected internal server error occurred. schema: $ref: '#/components/schemas/ApiError' description: >- Internal Server Error - The server encountered an unexpected condition that prevented it from fulfilling the request. securitySchemes: OrmiApiKey: description: > Enter your API key in the format: Bearer . Providing an API key may grant higher rate limits or access to additional features. The API will function without an API key for basic access. scheme: bearer type: http ````