Parameters

startLedger

string

REQUIRED

The ledger sequence number after which the events is to be fetched

filters

object

The list of filters for the returned events. A maximum of 5 filters are allowed per request

type

string

A list of event type (system, contract, or diagnostic) used to filter events. If omitted, all event types will be included

contractIds

array

A list of contract ids to query for events. A maximum of 5 contract IDs are allowed per request

topics

array

A list of topic filters. A maximum of 5 filters are allowed per request. Supports "**" wildcard pattern for matching

pagination

object

The pagination object which contains the following fields:

cursor

string

When provided it excludes the element with an ID matching the cursor and only includes elements appearing after it in the response

limit

integer

The maximum number of records returned. By default, it is set to 100

Returns

result

object

A result object with the following field:

events

array

An array of event objects emitted in the specified ledger range

type

string

The type of event, for example 'contract'

ledger

integer

The ledger number in which the event occurred

ledgerClosedAt

string

The timestamp when the ledger was closed, in ISO 8601 format

contractId

string

The unique identifier of the contract associated with the event

id

string

A unique identifier for the event within the ledger

operationIndex

integer

The index of the operation within the transaction that emitted this event

transactionIndex

integer

The index of the transaction within the ledger that emitted this event

txHash

string

The transaction hash that emitted the event

inSuccessfulContractCall

boolean

(DEPRECATED) Indicates whether the event was emitted from a successful contract call

topic

array[string]

An array of base64-encoded topic values related to the event. . Supports "**" wildcard pattern for matching

value

string

The emitted body value of the event as a base64-encoded XDR

cursor

string

A pagination token that can be used to request the next page of results

latestLedger

integer

The latest observed ledger number by the node at the time of response generation

oldestLedger

integer

The oldest ledger in the response range

latestLedgerCloseTime

string

The close time of the latest ledger as a Unix timestamp string

oldestLedgerCloseTime

string

The close time of the oldest ledger as a Unix timestamp string

Request

1
curl --location 'https://docs-demo.stellar-mainnet.quiknode.pro/' \
2
--header 'Content-Type: application/json' \
3
--data '{
4
    "jsonrpc": "2.0",
5
    "id": 8675309,
6
    "method": "getEvents",
7
    "params": {
8
        "startLedger": "LEDGER_SEQUENCE",
9
        "pagination": {
10
            "limit": 100
11
        }
12
    }
13
}'

1
curl --location 'https://docs-demo.stellar-mainnet.quiknode.pro/' \
2
--header 'Content-Type: application/json' \
3
--data '{
4
    "jsonrpc": "2.0",
5
    "id": 8675309,
6
    "method": "getEvents",
7
    "params": {
8
        "startLedger": "LEDGER_SEQUENCE",
9
        "pagination": {
10
            "limit": 100
11
        }
12
    }
13
}'

1
var myHeaders = new Headers();
2
myHeaders.append("Content-Type", "application/json");
3

4
var raw = JSON.stringify({
5
  "jsonrpc": "2.0",
6
  "id": 8675309,
7
  "method": "getEvents",
8
  "params": {
9
    "startLedger": "LEDGER_SEQUENCE",
10
    "pagination": {
11
      "limit": 100
12
    }
13
  }
14
});
15

16
var requestOptions = {
17
  method: 'POST',
18
  headers: myHeaders,
19
  body: raw,
20
  redirect: 'follow'
21
};
22

23
fetch("https://docs-demo.stellar-mainnet.quiknode.pro/", requestOptions)
24
  .then(response => response.text())
25
  .then(result => console.log(result))
26
  .catch(error => console.log('error', error));

1
var myHeaders = new Headers();
2
myHeaders.append("Content-Type", "application/json");
3

4
var raw = JSON.stringify({
5
  "jsonrpc": "2.0",
6
  "id": 8675309,
7
  "method": "getEvents",
8
  "params": {
9
    "startLedger": "LEDGER_SEQUENCE",
10
    "pagination": {
11
      "limit": 100
12
    }
13
  }
14
});
15

16
var requestOptions = {
17
  method: 'POST',
18
  headers: myHeaders,
19
  body: raw,
20
  redirect: 'follow'
21
};
22

23
fetch("https://docs-demo.stellar-mainnet.quiknode.pro/", requestOptions)
24
  .then(response => response.text())
25
  .then(result => console.log(result))
26
  .catch(error => console.log('error', error));

1
import requests
2
import json
3

4
url = "https://docs-demo.stellar-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "id": 8675309,
9
  "method": "getEvents",
10
  "params": {
11
    "startLedger": "LEDGER_SEQUENCE",
12
    "pagination": {
13
      "limit": 100
14
    }
15
  }
16
})
17
headers = {
18
  'Content-Type': 'application/json'
19
}
20

21
response = requests.request("POST", url, headers=headers, data=payload)
22

23
print(response.text)
24

1
import requests
2
import json
3

4
url = "https://docs-demo.stellar-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "id": 8675309,
9
  "method": "getEvents",
10
  "params": {
11
    "startLedger": "LEDGER_SEQUENCE",
12
    "pagination": {
13
      "limit": 100
14
    }
15
  }
16
})
17
headers = {
18
  'Content-Type': 'application/json'
19
}
20

21
response = requests.request("POST", url, headers=headers, data=payload)
22

23
print(response.text)
24

1
require "uri"
2
require "json"
3
require "net/http"
4

5
url = URI("https://docs-demo.stellar-mainnet.quiknode.pro/")
6

7
https = Net::HTTP.new(url.host, url.port)
8
https.use_ssl = true
9

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "jsonrpc": "2.0",
14
  "id": 8675309,
15
  "method": "getEvents",
16
  "params": {
17
    "startLedger": "LEDGER_SEQUENCE",
18
    "pagination": {
19
      "limit": 100
20
    }
21
  }
22
})
23

24
response = https.request(request)
25
puts response.read_body
26

1
require "uri"
2
require "json"
3
require "net/http"
4

5
url = URI("https://docs-demo.stellar-mainnet.quiknode.pro/")
6

7
https = Net::HTTP.new(url.host, url.port)
8
https.use_ssl = true
9

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "jsonrpc": "2.0",
14
  "id": 8675309,
15
  "method": "getEvents",
16
  "params": {
17
    "startLedger": "LEDGER_SEQUENCE",
18
    "pagination": {
19
      "limit": 100
20
    }
21
  }
22
})
23

24
response = https.request(request)
25
puts response.read_body
26

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free