MOCA API
integer · requiredstring · pattern: integer · min: 1integer · min: 1 · max: 100object
integer · requiredstring · pattern: string · required
Souls
Signed agent identity documents (SOUL files) for NFTs, served by Soulweaver — built for ERC-8004 / ERC-8183 / ERC-8257 integrations
List souls of a collection
GET
https://api.moca.qwellco.de
/v1/souls/{chainId}/{contractAddress}
Paginated SOUL files generated for a collection's tokens.
path Parameters
chainIdEVM chain id (1 = Ethereum mainnet)
contractAddress^0x[0-9a-fA-F]{40}$ · requiredERC-721 contract address
query Parameters
page1-based page number.
Default: 1
limitDefault: 50
List souls of a collection › Responses
Souls with pagination
dataGet a token's SOUL file
GET
https://api.moca.qwellco.de
/v1/souls/{chainId}/{contractAddress}/{tokenId}
The latest SOUL file for one NFT, including the EIP-191 verification block — recover the signer from verification.message and compare to soul.signerAddress to prove the identity document is authentic. See the Web3 & agents guide for ERC-8004 / ERC-8183 / ERC-8257 integration patterns.
path Parameters
chainIdEVM chain id (1 = Ethereum mainnet)
contractAddress^0x[0-9a-fA-F]{40}$ · requiredERC-721 contract address
tokenIdGet a token's SOUL file › Responses
SOUL file with verification block
Soul
A SOUL file: a portable, signed agent identity document for one NFT.