API Reference
Go to Nodit!

Ethereum Quickstart

이더리움(Ethereum)은 블록체인 기술을 기반으로 한 탈중앙화 플랫폼으로, 스마트 컨트랙트를 실행할 수 있는 환경을 제공합니다. 네트워크의 합의는 지분 증명(Proof of Stake, PoS) 메커니즘을 통해 이루어지며, NativeToken인 이더리움(ETH)는 거래 수수료와 네트워크 인센티브로 사용됩니다.

↗ 공식사이트: Ethereum Foundation

↗ Explorer: Ethereum Scan


Feature

Mainnet Support

Testnet(Sepolia) Support

Testnet(Holesky) Support

Elastic Node

✅

✅

✅

Dedicated Node

✅

✅

✅

Web3 Data API

✅

✅

✅

Webhook

✅

✅

✅

Stream

✅

✅

✅

Datasquare

✅

❌

❌

Node API

NetworkEndpoint
Mainnethttps://ethereum-mainnet.nodit.io/{{API-KEY}}
Testnet https://ethereum-sepolia.nodit.io/{{API-KEY}}
https://ethereum-holesky.nodit.io/{{API-KEY}}

  • eth

  • net

  • web3

  • trace

  • debug

  • Example

    • Request (Node.js)

      const axios = require('axios');
let data = JSON.stringify({
  "id": 1,
  "jsonrpc": "2.0",
  "method": "eth_getBalance",
  "params": [
    "0x9872F9cFD51dD9f5CF45a54F96a16eeE238A056a",
    "latest"
  ]
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://ethereum-mainnet.nodit.io/',
  headers: { 
    'Content-Type': 'application/json', 
    'Accept': 'application/json', 
    'X-API-KEY': '{{API-KEY}}'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

    • Response

      {
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x636e6b1e62893b04"
}

Web3 Data API

  • Blockchain API

  • Native API

  • Token API

  • NFT API

  • Statistics API

  • ENS API

  • Example

    • Request (Node.js)

      const axios = require('axios');
let data = JSON.stringify({
  "accountAddress": "0x9872F9cFD51dD9f5CF45a54F96a16eeE238A056a"
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://web3.nodit.io/v1/ethereum/mainnet/native/getNativeBalanceByAccount',
  headers: { 
    'Content-Type': 'application/json', 
    'X-API-KEY': '{{API-KEY}}'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

    • Response

      {
    "ownerAddress": "0x9872F9cFD51dD9f5CF45a54F96a16eeE238A056a",
    "balance": "7164781835439389444"
}

Ethereum Webhook API

Webhook Quickstart

Supported Webhook Types

Event TypeDescription
ADDRESS_ACTIVITY사용자가 지정한 주소 배열에 포함된 계정들의 활동을 모니터링합니다. 이 이벤트는 해당 계정들이 트랜잭션의 발신자(from) 또는 수신자(to)로 포함되어 있는 경우, 즉 트랜잭션, 토큰 전송(ERC20), 또는 NFT 전송(ERC721, ERC1155)이 발생할 때마다 알림을 제공합니다. 이 서비스는 사용자가 다수의 주소에 대한 활동을 실시간으로 파악할 수 있게 해 주어, 자산의 이동과 거래를 효과적으로 추적할 수 있도록 돕습니다.
MINED_TRANSACTION특정 주소가 발송한 트랜잭션이 블록체인 네트워크에 의해 성공적으로 채굴되고 최종적으로 확인되었을 때, 그 트랜잭션의 영수증(receipt) 정보를 알림으로 제공합니다. 이 이벤트는 트랜잭션이 성공적으로 처리된 경우, 그리고 실패한 경우 모두 알림을 받을 수 있습니다. 사용자는 이를 통해 자신이 발송한 트랜잭션의 최종 상태를 실시간으로 파악할 수 있으며, 트랜잭션의 성공 또는 실패 여부를 확인할 수 있습니다.
SUCCESSFUL_TRANSACTION특정 주소가 발송한 트랜잭션이 성공적으로 처리되었을 때 알림을 제공합니다. 이 이벤트는 트랜잭션이 블록체인 네트워크에 의해 완전히 확인되고 유효한 것으로 판정될 때 발생합니다. 사용자는 이를 통해 자신의 트랜잭션이 예상대로 실행되어 결과적으로 원하는 작업이 성공적으로 완료되었음을 확인할 수 있습니다.
FAILED_TRANSACTION특정 주소가 발송한 트랜잭션이 실패했을 때 알림을 제공합니다. 이 이벤트는 트랜잭션이 블록체인 네트워크에 의해 거부되거나, 실행 중 오류가 발생하여 완료되지 못했을 경우 발생합니다. 이를 통해 사용자는 트랜잭션 실패의 원인을 신속하게 파악하고, 필요한 조치를 취할 수 있습니다. 실패 이윤이 가스 부족, 계약 조건 불충족 등 다양한 기술적 문제로 인해 발생할 수 있으며, 이 이벤트는 블록체인 상의 트랜잭션 관리와 오류 추적을 보다 효과적으로 수행할 수 있게 도와줍니다.
TOKEN_TRANSFER토큰(ERC20) 전송 또는 NFT(ERC721, ERC1155) 전송이 발생할 경우 알림을 제공합니다. 사용자는 특정 컨트랙트 주소를 지정하여 해당 컨트랙트에서 발생하는 토큰 이동을 모니터링할 수 있습니다. 또한, ERC721과 ERC1155 표준에 따른 NFT의 경우, 특정 토큰 ID를 조건으로 설정하여 해당 ID의 토큰 전송만을 추적하는 것이 가능합니다.
BELOW_THRESHOLD_BALANCE지정된 계정의 잔고가 사용자가 설정한 특정 수치 이하로 떨어질 경우 알림을 제공합니다. 이 이벤트는 특히 재정 관리와 자산 보호에 중요한 역할을 합니다. 사용자는 이 기능을 통해 자신의 계정이 최소 잔고 아래로 떨어지지 않도록 예방 조치를 취할 수 있으며, 필요한 경우 적시에 추가 자금을 이체하거나 다른 금융 조치를 취할 수 있습니다.
BLOCK_PERIOD네트워크에서 생성되는 블록의 주기에 따라 알림을 제공합니다. 사용자는 원하는 블록 주기(예: 매 블록, N개의 블록마다)를 설정하여 해당 주기에 맞춰 블록 정보를 받을 수 있습니다. 이 이벤트는 특정 수의 블록이 확인된 후에 정보를 제공함으로써, 더욱 안정적이고 확정된 데이터를 제공합니다.
BLOCK_LIST_CALLER특정 주소 목록(block list)에 포함된 주소들이 대상 주소(target address)로 토큰을 전송할 때 알림을 제공합니다. 이 이벤트 타입은 주로 사전에 정의된 블록 리스트에 있는 주소들의 활동을 모니터링하고 싶을 때 활용됩니다. 예를 들어, 블랙리스트에 올라간 주소들이 특정 계정으로 자금을 이체하려고 시도할 때 즉시 경고를 받을 수 있습니다. 이를 통해 불법적이거나 의심스러운 자금 이동을 사전에 감지할 수 있는 유용한 도구입니다.
ALLOW_LIST_CALLER허용 리스트(allow list)에 포함된 주소들이 대상 주소로 토큰을 전송할 때 알림을 제공합니다. 이 리스트에는 신뢰할 수 있는 주소들이 포함되어 있으며, 해당 주소들로부터의 자금 이동은 안전하거나 예상된 활동으로 간주됩니다. 이 이벤트 타입은 허용된 주소들의 활동을 추적하고, 허용 리스트에 포함된 주소로부터의 자금 이체를 확증하고자 할 때 사용됩니다.
LOG지정한 스마트 컨트랙트 이벤트 로그가 포함된 트랜잭션이 생성될 때 알림을 제공합니다. 사용자는 하나 이상의 Event signature를 필터 조건으로 지정할 수 있습니다. 예를 들어, ERC20 표준의 토큰 전송 이벤트인 Transfer(address,address,uint256)를 모니터링하도록 설정하면, 해당 Event signature(0xddf252ad...)와 일치하는 모든 트랜잭션 로그가 캡처됩니다. LOG EventType을 활용하여 표준 토큰 전송 또는 특정 스마트 계약 이벤트와 같은 중요한 활동을 효율적으로 추적할 수 있습니다.

Webhook API

Ethereum Stream API

Kickstart Your Development