Wallets

GraphQL Endpoint

https://platform.beta.enjin.io/graphql

The Enjin Platform exposes two complementary read surfaces for wallets:

• GetAccount / GetAccounts — read any on-chain account by address (ENJ balance, held tokens, nonce).
• GetManagedWallet / GetManagedWallets — read platform-managed wallets (the keypairs your application creates via CreateManagedWallet).

VerifyMessage lets you cryptographically verify that a given signature belongs to a given address — useful for signed-message ownership proofs in WalletConnect-style flows.

GetAccount

Returns a single chain account. The response includes the ENJ balance (in the smallest unit — divide by 10¹⁸ for ENJ) and a flat list of tokens the account holds.

GraphQL

query GetAccount {
  GetAccount(
    network: ENJIN
    chain: MATRIX
    address: "efRC9jw5LeZFqmaWBBDxZRTyaLP9dLAqixy32tSnqW9wCsb6y"
  ) {
    id
    address
    nonce
    balance
    tokens {
      id
      tokenId
      isNonFungible
      collection {
        id
      }
      metadata {
        name
      }
    }
  }
}

Response

{
  "data": {
    "GetAccount": {
      "id": "efRC9jw5LeZFqmaWBBDxZRTyaLP9dLAqixy32tSnqW9wCsb6y",
      "address": "efRC9jw5LeZFqmaWBBDxZRTyaLP9dLAqixy32tSnqW9wCsb6y",
      "nonce": 132,
      "balance": "17500000000000000000",
      "tokens": [
        {
          "id": "2967-107002853660685728525072975374659356720",
          "tokenId": "107002853660685728525072975374659356720",
          "isNonFungible": false,
          "collection": { "id": "2967" },
          "metadata": { "name": "Epochrome Sword" }
        }
      ]
    }
  }
}

GetAccounts

The batched form of GetAccount. Pass a list of addresses and the platform returns an Account per entry.

GraphQL

query GetAccounts {
  GetAccounts(
    network: ENJIN
    chain: MATRIX
    addresses: [
      "efRC9jw5LeZFqmaWBBDxZRTyaLP9dLAqixy32tSnqW9wCsb6y"
      "efUfmhm2rcTtVr4ajneB71qbfDZ1EkyYW7xRc6fhuRh3Tg4L1"
    ]
  ) {
    address
    balance
    nonce
  }
}

Response

{
  "data": {
    "GetAccounts": [
      {
        "address": "efRC9jw5LeZFqmaWBBDxZRTyaLP9dLAqixy32tSnqW9wCsb6y",
        "balance": "17500000000000000000",
        "nonce": 132
      },
      {
        "address": "efUfmhm2rcTtVr4ajneB71qbfDZ1EkyYW7xRc6fhuRh3Tg4L1",
        "balance": "5000000000000000000",
        "nonce": 47
      }
    ]
  }
}

GetManagedWallet

Looks up a platform-managed wallet by either externalId (the string you set when calling CreateManagedWallet) or publicKey (the hex public key). Returns the wallet's public key and externalId — pass either back as recipient on mint/transfer actions or as signerAddress / signerExternalId on CreateTransaction.

GraphQL

query GetManagedWallet {
  GetManagedWallet(
    network: ENJIN
    chain: MATRIX
    externalId: "e73f9f38-6832-4822-922b-b9225245ba24"
  ) {
    publicKey
    externalId
  }
}

Response

{
  "data": {
    "GetManagedWallet": {
      "publicKey": "0xded3c8a93e4a4b3a5e8f3c9a2d1b6f0e7c8a9b0d1e2f3a4b5c6d7e8f9a0b1c2d",
      "externalId": "e73f9f38-6832-4822-922b-b9225245ba24"
    }
  }
}

GetManagedWallets

Returns a paginated list of managed wallets. Pagination is cursor-based — pass the previous response's nextCursor to fetch the next page; a null nextCursor means there are no more.

You can optionally filter to specific publicKeys or externalIds.

GraphQL

query GetManagedWallets {
  GetManagedWallets(
    network: ENJIN
    chain: MATRIX
    limit: 15
  ) {
    data {
      publicKey
      externalId
    }
    perPage
    nextCursor
    previousCursor
  }
}

Response

{
  "data": {
    "GetManagedWallets": {
      "data": [
        {
          "publicKey": "0xded3c8a9...",
          "externalId": "user-1"
        },
        {
          "publicKey": "0x84f12b67...",
          "externalId": "user-2"
        }
      ],
      "perPage": 15,
      "nextCursor": "eyJpZCI6Mn0=",
      "previousCursor": null
    }
  }
}

VerifyMessage

Cryptographically verifies that signature was produced by the holder of publicKey over message. Returns true or false. Useful for signed-message ownership proofs — for example, prompting a user's wallet to sign a unique challenge string so your backend can confirm they control the address.

GraphQL

query VerifyMessage {
  VerifyMessage(
    network: ENJIN
    chain: MATRIX
    publicKey: "0xded3c8a93e4a4b3a5e8f3c9a2d1b6f0e7c8a9b0d1e2f3a4b5c6d7e8f9a0b1c2d"
    signature: "0x8958f002f9513256fa329fa92441d39adc59e3a19165aeeb343acd72b7f6a..."
    message: "Sign in to MyGame at 2026-05-25T14:32:00Z"
  )
}

Response

{
  "data": {
    "VerifyMessage": true
  }
}