v1

latestOpenAPI 3.1.02026-07-2685154311.7 KB

Address Ownership

Discover address ownership information

Performs agent discovery for a given blockchain address using multiple methods:

Relationships (confirmed/unconfirmed)
Hashed Address Service
Blockchain Analytics (if configured)

Returns the discovered agent/VASP information, custodian, jurisdiction, relationship status, and ownership proofs (when available).

Authentication: Supports both M2M tokens and delegate tokens for automated integrations.

post/entities/{entityDID}/address-ownership/discover

Path parameters

entityDIDstring did required

Decentralized Identifier (DID)

Example:did:web:vasps.id:jxnl0411:at

The DID of the entity

Request body

assetstring required

addressstring required

Example request

{
  "asset": "ETH",
  "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb1"
}

Response

Address ownership discovered successfully

Example response

{
  "addressOwnership": {
    "agent": {
      "did": "did:web:example.com",
      "name": "Example VASP",
      "jurisdiction": "US"
    },
    "custodian": {
      "did": "did:web:example.com",
      "name": "Example VASP",
      "jurisdiction": "US"
    },
    "relationship": {
      "proofs": [
        {
          "type": "EIP191",
          "status": "Confirmed",
          "did": "did:web:example.com",
          "address": "eip155:1:0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb1",
          "proof": "0xsignature...",
          "attestation": "0xattestation...",
          "createdAt": "2025-01-15T10:00:00.000Z"
        }
      ]
    }
  }
}