Smart Account Indexer

Mercury runs a free, public indexer for smart accounts (passkey wallets) on Stellar. It indexes the OpenZeppelin smart-account events (context rules, signers, policies) live on both mainnet and testnet, with the full smart-account history already indexed on both networks, and serves them through a REST API compatible with the smart-account-kit IndexerClient: point the kit's indexerUrl at Mercury and everything works unchanged.

The indexer is currently free to use, and for now requires no authentication or API key.

Base URLs

Network	indexerUrl
Testnet	https://testnet.mercurydata.app/rest/smart-account-indexer
Mainnet	https://mainnet.mercurydata.app/rest/smart-account-indexer

Usage with smart-account-kit

Set the indexer URL in your kit configuration to the Mercury base URL for your network. Nothing else changes:

indexerUrl: "https://testnet.mercurydata.app/rest/smart-account-indexer"

Endpoints

All endpoints are GET, public, and return JSON.

Endpoint	Description
/	Health check: {"status":"ok","service":"smart-account-indexer"}
/api/lookup/:credentialId	Find smart accounts by passkey credential ID (hex, 0x prefix optional, case-insensitive)
/api/lookup/address/:address	Find smart accounts by signer address
/api/contract/:contractId	Full details for one smart account: context rules, signers, policies
/api/stats	Indexer statistics: totals, ledger range, per-event-type counts

Example:

curl https://testnet.mercurydata.app/rest/smart-account-indexer/api/lookup/aabbcc...

{
  "credentialId": "aabbcc...",
  "contracts": [
    {
      "contract_id": "C...",
      "context_rule_count": 1,
      "external_signer_count": 1,
      "delegated_signer_count": 0,
      "native_signer_count": 0,
      "first_seen_ledger": 123456,
      "last_seen_ledger": 123789,
      "context_rule_ids": [0]
    }
  ],
  "count": 1
}

Lookups match active signers only: if a signer was removed, or all of a contract's context rules were removed, the contract no longer resolves through /api/lookup/* (and /api/contract/:contractId returns 404 once no rules remain).