The Logs API from BscScan — 3 operation(s) for logs.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/bscscan:bscscan-logs-api"curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: BscScan Logs API
version: 1.0.0
description: BscScan is the leading block explorer and analytics platform for BNB Smart Chain (BSC), providing a REST API for querying transactions, token transfers, smart contract ABIs, gas prices, BEP-20 token information, and on-chain statistics. API subscriptions are unified under the Etherscan V2 platform, enabling access to 60+ EVM chains via a single API key using the chainid parameter (BSC chainid=56).
license:
name: UNLICENSED
url: https://docs.bscscan.com/
servers:
- url: https://api.bscscan.com/v2/api
description: BscScan BNB Smart Chain Mainnet (Etherscan V2, chainid=56)
- url: https://api-testnet.bscscan.com/api
description: BscScan BNB Smart Chain Testnet
security:
- apiKeyAuth: []
tags:
- name: Logs
paths:
/?module=logs&action=getLogs:
get:
operationId: get-event-logs-by-address
externalDocs:
url: https://docs.bscscan.com/api-endpoints/logs#get-event-logs-by-address
summary: Get Event Logs by Address
description: Returns the event logs from an address, with optional filtering by block range.
tags:
- Logs
parameters:
- in: query
name: address
schema:
$ref: '#/components/schemas/AddressHash'
required: true
example: '0xbd3531da5cf5857e7cfaa92426877b022e612cf8'
- in: query
name: fromBlock
schema:
$ref: '#/components/schemas/IntegerMin0'
required: true
example: '12878196'
- in: query
name: toBlock
schema:
$ref: '#/components/schemas/IntegerMin0'
required: true
example: '12878196'
- in: query
name: page
schema:
$ref: '#/components/schemas/IntegerMin1'
required: false
example: '1'
- in: query
name: offset
schema:
$ref: '#/components/schemas/IntegerMin1Max1000'
required: false
example: '1000'
responses:
'200':
description: Operation result.
content:
application/json:
schema:
oneOf:
- allOf:
- $ref: '#/components/schemas/ResponseOK'
- $ref: '#/components/schemas/ResultArrayOfObjects'
- $ref: '#/components/schemas/ResponseNOTOK'
example:
status: '1'
message: OK
result:
- address: '0xbd3531da5cf5857e7cfaa92426877b022e612cf8'
topics:
- '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef'
- '0x0000000000000000000000000000000000000000000000000000000000000000'
- '0x000000000000000000000000c45a4b3b698f21f88687548e7f5a80df8b99d93d'
- '0x00000000000000000000000000000000000000000000000000000000000000b5'
data: 0x
blockNumber: '0xc48174'
timeStamp: '0x60f9ce56'
gasPrice: '0x2e90edd000'
gasUsed: '0x247205'
logIndex: 0x
transactionHash: '0x4ffd22d986913d33927a392fe4319bcd2b62f3afe1c15a2c59f77fc2cc4c20a9'
transactionIndex: 0x
- address: '0xbd3531da5cf5857e7cfaa92426877b022e612cf8'
topics:
- '0x645f26e653c951cec836533f8fe0616d301c20a17153debc17d7c3dbe4f32b28'
- '0x00000000000000000000000000000000000000000000000000000000000000b5'
data: 0x
blockNumber: '0xc48174'
timeStamp: '0x60f9ce56'
gasPrice: '0x2e90edd000'
gasUsed: '0x247205'
logIndex: '0x1'
transactionHash: '0x4ffd22d986913d33927a392fe4319bcd2b62f3afe1c15a2c59f77fc2cc4c20a9'
transactionIndex: 0x
/?module=logs&action=getLogs&get-event-logs-by-topics:
get:
operationId: get-event-logs-by-topics
externalDocs:
url: https://docs.bscscan.com/api-endpoints/logs#get-event-logs-by-topics
summary: Get Event Logs by Topics
description: Returns the events log in a block range, filtered by topics.
tags:
- Logs
parameters:
- in: query
name: fromBlock
schema:
$ref: '#/components/schemas/IntegerMin0'
required: true
example: '12878196'
- in: query
name: toBlock
schema:
$ref: '#/components/schemas/IntegerMin0'
required: true
example: '12879196'
- in: query
name: topic
schema:
$ref: '#/components/schemas/Topic'
required: true
example: ''
- in: query
name: topicOperator
schema:
$ref: '#/components/schemas/TopicOperator'
required: false
example: ''
- in: query
name: page
schema:
$ref: '#/components/schemas/IntegerMin1'
required: false
example: '1'
- in: query
name: offset
schema:
$ref: '#/components/schemas/IntegerMin1Max1000'
required: false
example: '1000'
responses:
'200':
description: Operation result.
content:
application/json:
schema:
oneOf:
- allOf:
- $ref: '#/components/schemas/ResponseOK'
- $ref: '#/components/schemas/ResultArrayOfObjects'
- $ref: '#/components/schemas/ResponseNOTOK'
example:
status: '1'
message: OK
result:
- address: '0xbd3531da5cf5857e7cfaa92426877b022e612cf8'
topics:
- '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef'
- '0x0000000000000000000000000000000000000000000000000000000000000000'
- '0x000000000000000000000000c45a4b3b698f21f88687548e7f5a80df8b99d93d'
- '0x00000000000000000000000000000000000000000000000000000000000000b5'
data: 0x
blockNumber: '0xc48174'
timeStamp: '0x60f9ce56'
gasPrice: '0x2e90edd000'
gasUsed: '0x247205'
logIndex: 0x
transactionHash: '0x4ffd22d986913d33927a392fe4319bcd2b62f3afe1c15a2c59f77fc2cc4c20a9'
transactionIndex: 0x
- address: '0xbd3531da5cf5857e7cfaa92426877b022e612cf8'
topics:
- '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef'
- '0x0000000000000000000000000000000000000000000000000000000000000000'
- '0x000000000000000000000000c45a4b3b698f21f88687548e7f5a80df8b99d93d'
- '0x00000000000000000000000000000000000000000000000000000000000000b6'
data: 0x
blockNumber: '0xc48174'
timeStamp: '0x60f9ce56'
gasPrice: '0x2e90edd000'
gasUsed: '0x247205'
logIndex: '0x2'
transactionHash: '0x4ffd22d986913d33927a392fe4319bcd2b62f3afe1c15a2c59f77fc2cc4c20a9'
transactionIndex: 0x
/?module=logs&action=getLogs&get-event-logs-by-address-filtered-by-topics:
get:
operationId: get-event-logs-by-address-filtered-by-topics
externalDocs:
url: https://docs.bscscan.com/api-endpoints/logs#get-event-logs-by-address-filtered-by-topics
summary: Get Event Logs by Address filtered by Topics
description: Returns the event logs from an address, filtered by topics and block range.
tags:
- Logs
parameters:
- in: query
name: fromBlock
schema:
$ref: '#/components/schemas/IntegerMin0'
required: true
example: '15073139'
- in: query
name: toBlock
schema:
$ref: '#/components/schemas/IntegerMin0'
required: true
example: '15074139'
- in: query
name: address
schema:
$ref: '#/components/schemas/AddressHash'
required: true
example: '0x59728544b08ab483533076417fbbb2fd0b17ce3a'
- in: query
name: topic
schema:
$ref: '#/components/schemas/Topic'
required: true
example: ''
- in: query
name: topicOperator
schema:
$ref: '#/components/schemas/TopicOperator'
required: false
example: ''
- in: query
name: page
schema:
$ref: '#/components/schemas/IntegerMin1'
required: false
example: '1'
- in: query
name: offset
schema:
$ref: '#/components/schemas/IntegerMin1Max1000'
required: false
example: '1000'
responses:
'200':
description: Operation result.
content:
application/json:
schema:
oneOf:
- allOf:
- $ref: '#/components/schemas/ResponseOK'
- $ref: '#/components/schemas/ResultArrayOfObjects'
- $ref: '#/components/schemas/ResponseNOTOK'
example:
status: '1'
message: OK
result:
- address: '0x59728544b08ab483533076417fbbb2fd0b17ce3a'
topics:
- '0x27c4f0403323142b599832f26acd21c74a9e5b809f2215726e244a4ac588cd7d'
- '0x00000000000000000000000023581767a106ae21c074b2276d25e5c3e136a68b'
- '0x000000000000000000000000000000000000000000000000000000000000236d'
- '0x000000000000000000000000c8a5592031f93debea5d9e67a396944ee01bb2ca'
data: '0x000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000000000000000000000000000000f207539952d0000'
blockNumber: '0xe60262'
timeStamp: '0x62c26caf'
gasPrice: '0x5e2d742c9'
gasUsed: '0xfb7f8'
logIndex: '0x4b'
transactionHash: '0x26fe1a0a403fd44ef11ee72f3b4ceff590b6ea533684cb279cb4242be463304c'
transactionIndex: '0x39'
- address: '0x59728544b08ab483533076417fbbb2fd0b17ce3a'
topics:
- '0x27c4f0403323142b599832f26acd21c74a9e5b809f2215726e244a4ac588cd7d'
- '0x00000000000000000000000023581767a106ae21c074b2276d25e5c3e136a68b'
- '0x0000000000000000000000000000000000000000000000000000000000002261'
- '0x000000000000000000000000c8a5592031f93debea5d9e67a396944ee01bb2ca'
data: '0x000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000000000000000000000000000000de0b6b3a7640000'
blockNumber: '0xe6035b'
timeStamp: '0x62c27ab1'
gasPrice: '0x27e523173'
gasUsed: '0x3b86e'
logIndex: '0x1d7'
transactionHash: '0x3a299413cf2c91e376e542efcf3fc308c562da79af6e992401217cc6208c7f74'
transactionIndex: '0x92'
components:
schemas:
IntegerMin0:
type: integer
minimum: 0
ResponseNOTOK:
type: object
properties:
status:
type: string
enum:
- '0'
message:
type: string
pattern: ^NOTOK(-.*)?$
examples:
- NOTOK
- NOTOK-Missing/Invalid API Key, rate limit of 1/5sec applied
result:
type: string
required:
- status
- message
- result
IntegerMin1Max1000:
type: integer
format: int32
minimum: 1
maximum: 1000
IntegerMin1:
type: integer
minimum: 1
TopicOperator:
type: string
enum:
- and
- or
Topic:
type: string
enum:
- topic0
- topic1
- topic2
- topic3
ResponseOK:
type: object
properties:
status:
type: string
enum:
- '1'
message:
type: string
enum:
- OK
result:
description: call result
required:
- status
- message
- result
ArrayOfObjects:
type: array
items:
type: object
additionalProperties: true
AddressHash:
type: string
pattern: 0x[A-Fa-f0-9]{40}
example: '0x01234567890abcdef01234567890abcdef012345'
ResultArrayOfObjects:
type: object
properties:
result:
$ref: '#/components/schemas/ArrayOfObjects'
securitySchemes:
apiKeyAuth:
type: apiKey
in: query
name: apikey
externalDocs:
url: https://docs.bscscan.com/