Get contract events

POST

https://soroban-futurenet.nownodes.io/soroban/rpc

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns contract events

Body

application/json

jsonrpcstringrequired

idintegerrequired

methodstringrequired

paramsobjectrequired

Show child attributes

startLedgerintegerrequired

filtersArray<object>required

Show child attributes

typestring

contractIdsArray<string>

topicsArray<Array<string>>

paginationobject

Show child attributes

limitinteger

Response

200OK

Contract events retrieved successfully

400Bad Request

Bad Request

401Unauthorized

Unauthorized — Missing or invalid API key

500Internal Server Error

Internal Server Error

Get contract events

curl -X POST 'https://soroban-futurenet.nownodes.io/soroban/rpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 8675309,
    "method": "getEvents",
    "params": {
      "startLedger": 1190000,
      "filters": [
        {
          "type": "contract",
          "contractIds": [
            "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC"
          ],
          "topics": [
            [
              "AAAADwAAAAh0cmFuc2Zlcg==",
              "*",
              "*",
              "*"
            ]
          ]
        }
      ],
      "pagination": {
        "limit": 2
      }
    }
  }'

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("https://soroban-futurenet.nownodes.io/soroban/rpc");
const result = await provider.send("getEvents", {
  "startLedger": 1190000,
  "filters": [
    {
      "type": "contract",
      "contractIds": [
        "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC"
      ],
      "topics": [
        [
          "AAAADwAAAAh0cmFuc2Zlcg==",
          "*",
          "*",
          "*"
        ]
      ]
    }
  ],
  "pagination": {
    "limit": 2
  }
});
console.log(result);

require 'eth'
require 'json'
require 'net/http'

uri = URI('https://soroban-futurenet.nownodes.io/soroban/rpc')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
  "jsonrpc": "2.0",
  "method": "getEvents",
  "params": {
    "startLedger": 1190000,
    "filters": [
      {
        "type": "contract",
        "contractIds": [
          "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC"
        ],
        "topics": [
          [
            "AAAADwAAAAh0cmFuc2Zlcg==",
            "*",
            "*",
            "*"
          ]
        ]
      }
    ],
    "pagination": {
      "limit": 2
    }
  },
  "id": 1
}'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts JSON.parse(response.body)

from web3 import Web3

w3 = Web3(Web3.HTTPProvider("https://soroban-futurenet.nownodes.io/soroban/rpc"))
response = w3.provider.make_request("getEvents", {
  "startLedger": 1190000,
  "filters": [
    {
      "type": "contract",
      "contractIds": [
        "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC"
      ],
      "topics": [
        [
          "AAAADwAAAAh0cmFuc2Zlcg==",
          "*",
          "*",
          "*"
        ]
      ]
    }
  ],
  "pagination": {
    "limit": 2
  }
})
print(response)

import { createPublicClient, http } from "viem";

const client = createPublicClient({
  transport: http("https://soroban-futurenet.nownodes.io/soroban/rpc"),
});

const result = await client.request({
  method: "getEvents",
  params: {
  "startLedger": 1190000,
  "filters": [
    {
      "type": "contract",
      "contractIds": [
        "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC"
      ],
      "topics": [
        [
          "AAAADwAAAAh0cmFuc2Zlcg==",
          "*",
          "*",
          "*"
        ]
      ]
    }
  ],
  "pagination": {
    "limit": 2
  }
},
});

console.log(result);

const endpoint = "https://soroban-futurenet.nownodes.io/soroban/rpc";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({ jsonrpc: "2.0", method: "getEvents", params: {
  "startLedger": 1190000,
  "filters": [
    {
      "type": "contract",
      "contractIds": [
        "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC"
      ],
      "topics": [
        [
          "AAAADwAAAAh0cmFuc2Zlcg==",
          "*",
          "*",
          "*"
        ]
      ]
    }
  ],
  "pagination": {
    "limit": 2
  }
}, id: 1 });
console.log(result);

const response = await fetch('https://soroban-futurenet.nownodes.io/soroban/rpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 8675309,
      "method": "getEvents",
      "params": {
        "startLedger": 1190000,
        "filters": [
          {
            "type": "contract",
            "contractIds": [
              "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC"
            ],
            "topics": [
              [
                "AAAADwAAAAh0cmFuc2Zlcg==",
                "*",
                "*",
                "*"
              ]
            ]
          }
        ],
        "pagination": {
          "limit": 2
        }
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 8675309,
  "method": "getEvents",
  "params": {
    "startLedger": 1190000,
    "filters": [
      {
        "type": "contract",
        "contractIds": [
          "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC"
        ],
        "topics": [
          [
            "AAAADwAAAAh0cmFuc2Zlcg==",
            "*",
            "*",
            "*"
          ]
        ]
      }
    ],
    "pagination": {
      "limit": 2
    }
  }
}

response = requests.post('https://soroban-futurenet.nownodes.io/soroban/rpc', json=payload)
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://soroban-futurenet.nownodes.io/soroban/rpc')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "jsonrpc": "2.0",
    "id": 8675309,
    "method": "getEvents",
    "params": {
      "startLedger": 1190000,
      "filters": [
        {
          "type": "contract",
          "contractIds": [
            "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC"
          ],
          "topics": [
            [
              "AAAADwAAAAh0cmFuc2Zlcg==",
              "*",
              "*",
              "*"
            ]
          ]
        }
      ],
      "pagination": {
        "limit": 2
      }
    }
  }'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

Request Body

{
  "jsonrpc": "2.0",
  "id": 8675309,
  "method": "getEvents",
  "params": {
    "startLedger": 1190000,
    "filters": [
      {
        "type": "contract",
        "contractIds": [
          "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC"
        ],
        "topics": [
          [
            "AAAADwAAAAh0cmFuc2Zlcg==",
            "*",
            "*",
            "*"
          ]
        ]
      }
    ],
    "pagination": {
      "limit": 2
    }
  }
}

200

{
  "jsonrpc": "2.0",
  "id": 8675309,
  "result": {
    "events": [
      {
        "type": "contract",
        "ledger": 1192402,
        "ledgerClosedAt": "2024-04-19T06:19:00Z",
        "contractId": "CDLZFC3SYJYDZT7K67VZ75HPJVIEUVNIXF47ZG2FB2RMQQVU2HHGCYSC",
        "id": "0005121327593697280-0000000002",
        "pagingToken": "0005121327593697280-0000000002",
        "topic": [
          "AAAADwAAAAh0cmFuc2Zlcg==",
          "AAAAEgAAAAAAAAAA/ItF3cwsGhkee6lL5X6kicifdluxtsuDq9J/F0zou6Q=",
          "AAAAEgAAAAAAAAAA2uSCoRk2StNEYAmWOhGXKQg0SLV6avaiN7TdV/uMozQ=",
          "AAAADgAAAAZuYXRpdmUAAA=="
        ],
        "value": "AAAACgAAAAAAAAAAAAAAAAX14QA=",
        "inSuccessfulContractCall": true,
        "txHash": "bd8a6611a3b44ff7dce76a27fb32fa69c9f6eff3435ca5296f6035d5105617ed"
      }
    ],
    "latestLedger": 1197926
  }
}

Documentation

How to migrate to NOWNodes

Get contract events

Authorizations

Body

Response