Skip to main content
GET
/
v1
/
server
/
addresses
/
lookup
Lookup Address
curl --request GET \
  --url https://api.example.com/v1/server/addresses/lookup \
  --header 'X-Access-Key: <x-access-key>' \
  --header 'X-Signature: <x-signature>' \
  --header 'X-Timestamp: <x-timestamp>'
{
  "address": {}
}

​
Lookup Address

Find an address record by its blockchain address string.

​
Authentication

​
X-Access-Key
string
required
API access key
​
X-Signature
string
required
HMAC-SHA256 signature
​
X-Timestamp
string
required
ISO 8601 timestamp

​
Query Parameters

​
address
string
required
The blockchain address to look up
​
chainId
string
Chain identifier to narrow search

​
Response

​
address
object
Address details if found

​
Example

curl -X GET "https://api.axonvault.io/v1/server/addresses/lookup?address=0x742d35Cc6634C0532925a3b844Bc9e7595f8fE00&chainId=eip155:1" \
  -H "X-Access-Key: ak_live_abc123" \
  -H "X-Signature: sha256=..." \
  -H "X-Timestamp: 2024-01-15T10:30:00Z"
Response: 
{
  "address": {
    "addressId": "addr_abc123",
    "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f8fE00",
    "chainId": "eip155:1",
    "derivationPath": "m/44'/60'/0'/0/0",
    "accountId": "acc_xyz789",
    "walletId": "wal_abc123",
    "createdAt": "2024-01-15T10:35:00Z"
  }
}
Not Found Response: 
{
  "errorType": "ADDRESS_NOT_FOUND",
  "errorMessage": "Address not found in this project"
}