NEUS Docs | Trust Infrastructure for Apps and Agents

Headers

x-wallet-address

string

x-signature

string

x-signed-timestamp

string

x-chain

string

CAIP-2 chain reference for non-EVM signature verification (e.g. solana:mainnet)

x-signature-method

string

Signature method hint for non-EVM signatures (e.g. ed25519)

Query Parameters

address

string

qHash

string

Pattern: ^0x[a-fA-F0-9]{64}$

gateId

string

Maximum string length: 80

Pattern: ^[a-zA-Z0-9:_-]+$

verifierIds

string

verifierId

string

requireAll

boolean

minCount

integer

Required range: 1 <= x <= 1000

sinceDays

integer

Required range: 1 <= x <= 3650

since

integer

Required range: x >= 0

limit

integer

Required range: 1 <= x <= 1000

referenceType

string

referenceId

string

tag

string

tags

string

contentType

string

content

string

contentHash

string

contractAddress

string

tokenId

string

chainId

integer

EVM chain ID of the asset being checked (e.g. 1 for Ethereum Mainnet, 8453 for Base). Required for asset verifiers (nft-ownership, token-holding, contract-ownership). Not a hub or proof-storage filter.

Required range: x >= 1

domain

string

minBalance

string

provider

string

handle

string

namespace

string

When set, requires ownership-pseudonym proofs to include this namespace (matches verifier data.namespace; legacy proofs without namespace default to neus).

Required string length: 1 - 64

Pattern: ^[a-z0-9._-]+$

traitPath

string

traitGte

number

Required range: x >= 0

select

string

ownerAddress

string

riskLevel

string

sanctioned

boolean

poisoned

boolean

primaryWalletAddress

string

secondaryWalletAddress

string

controllerWallet

string

Approving account (delegation grantor) for agent-delegation checks; optional filter. Not the agent wallet.

agentWallet

string

delegationScope

string

agentId

string

verificationMethod

string

neusPersonhoodId

string

ageMin

integer

Required range: 0 <= x <= 150

sanctionsPassed

boolean

subject

enum<string>

Available options:

me

includePrivate

boolean

Response

success

enum<boolean>

required

Available options:

true

data

object

required

timestamp