Developer API

Ethereum SNS API Documentation

Build decentralized identity solutions with our Ethereum-native API for cryptographic verification, social authentication, and zero-knowledge interaction.

API Endpoints

Authentication

Use an API key in the Authorization header for authenticated requests. Your key is available in the developer portal.

Authorization: Bearer <your_api_key>

Identity Verification

POST

/api/v1/verify-identity

Verify an identity proof using a zero-knowledge attestation.

Parameters:
  • identityHash: string
  • proof: string

Social Graph Query

GET

/api/v1/social-graph/{address}

Retrieve the social connections and on-chain activity for a given Ethereum address.

Parameters:
  • address: string

Wallet Initialization

POST

/api/v1/wallet-init

Initialize a new cryptographic wallet for Ethereum SNS identity verification.

Parameters:
  • walletType: string

API Playground

Request

Response

{
  "status" : 200,
  "message" : "Success",
  "data" : {
    "isVerified" : true,
    "validUntil" : "2025-10-01T00:00:00Z",
    "identityProofType" : "ZK-SNARK",
    "issuer" : "0x00000000000000000000000000000000000000",
    "timestamp" : 1631011200
  }
}