Authentication

Use your account API key.

Required header:

X-Api-Key: evk_your_live_key

This applies to:

• https://search-<endpoint>.evmkit.app/v1/
• wss://search-<endpoint>.evmkit.app/v1/monitoring/unhealthy/ws
• https://rpc-<endpoint>.evmkit.app/
• wss://streams-<endpoint>.evmkit.app/pending-txs
• wss://streams-<endpoint>.evmkit.app/new-blocks
• wss://streams-<endpoint>.evmkit.app/pending-logs

Replace <endpoint> with your chosen regional endpoint. See Regions for the current layout.

Search API example

curl --http2 -sS https://search-<endpoint>.evmkit.app/v1/size \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: evk_your_live_key' \
  --data '{
    "state": {
      "hash": "0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
      "request": {
        "from": "0x1111111111111111111111111111111111111111",
        "to": "0x0000000000000000000000000000000000000000",
        "value": "0x0",
        "input": "0x"
      }
    },
    "blockNumber": "0x16e3600",
    "items": [
      {
        "range": {
          "from": "1",
          "to": "1000000"
        },
        "settings": {
          "profile": "balanced"
        },
        "request": {
          "from": "0x1234567890123456789012345678901234567890",
          "to": "0x1234567890123456789012345678901234567890",
          "value": "0x0",
          "input": [
            {
              "kind": "hex",
              "data": "0xabcdef"
            },
            {
              "kind": "amount",
              "codec": "u24be"
            }
          ]
        }
      }
    ]
  }'

RPC API example

curl --http2 -sS https://rpc-<endpoint>.evmkit.app/ \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: evk_your_live_key' \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "evmkit_pendingBlock",
    "params": []
  }'

Streams API example

npx wscat -c wss://streams-<endpoint>.evmkit.app/pending-txs -H 'X-Api-Key: evk_your_live_key'

Authentication is checked during every websocket handshake.