Address details
Full address data: balance (raw + decimal), asset information, the last 20 outgoing and 20 incoming operations. The full paginated feed is GET /vaults/{code}/history?addressId=...
curl -X GET "https://policy-engine-rest.ezig.workers.dev/api/v1/vaults/demo_vault/addresses/example_string" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN"
import requests
import json
url = "https://policy-engine-rest.ezig.workers.dev/api/v1/vaults/demo_vault/addresses/example_string"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://policy-engine-rest.ezig.workers.dev/api/v1/vaults/demo_vault/addresses/example_string", {
method: "GET",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
}
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://policy-engine-rest.ezig.workers.dev/api/v1/vaults/demo_vault/addresses/example_string", nil)
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://policy-engine-rest.ezig.workers.dev/api/v1/vaults/demo_vault/addresses/example_string')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer YOUR_API_TOKEN'
response = http.request(request)
puts response.body
{
"id": "cmr3f41z20001psp7phmyapw3",
"address": "TQ5kohbBSdorGoDBmCGUmDL7RUvNr75mBC",
"derivationPath": "m/44/195/0/0/1/1/0",
"network": "tron",
"pathIndex": 42,
"segmentsJson": {
"app_id": 0,
"purpose": 1,
"asset": 1,
"stage": 0
},
"label": "example_string",
"description": "example_string",
"tagsJson": [
"example_string"
],
"logoUri": "example_string",
"color": "#000",
"emoji": "💳",
"balance": "1500000",
"balances": [
{
"tokenId": "example_string",
"asset": "usdt",
"symbol": "USDT",
"decimals": 42,
"available": "example_string",
"availableDecimal": "1.951234",
"reserved": "example_string",
"reservedDecimal": "example_string"
}
],
"tokenId": "example_string",
"createdAt": "2026-07-02T11:25:15.134000Z",
"asset": "usdt",
"assetName": "John Doe",
"assetSymbol": "USDT",
"balanceDecimal": "1.5",
"vault": {
"id": "example_string",
"code": "test_vault",
"name": "John Doe"
},
"createdBy": {
"id": "example_string",
"name": "John Doe",
"username": "John Doe",
"image": "example_string",
"color": "example_string",
"emoji": "example_string"
},
"owner": {
"id": "example_string",
"name": "John Doe",
"username": "John Doe",
"image": "example_string",
"color": "example_string",
"emoji": "example_string"
},
"access": {
"isOwner": true,
"isAdmin": true,
"canView": true,
"canTransfer": true
},
"shares": [
{
"id": "example_string",
"subjectType": "user",
"subject": {
"id": "example_string",
"name": "John Doe",
"username": "John Doe",
"image": "example_string",
"color": "example_string",
"emoji": "example_string"
},
"subjectGroup": {
"id": "example_string",
"name": "John Doe"
},
"canView": true,
"canTransfer": true,
"via": "address",
"viaGroup": {
"id": "example_string",
"name": "John Doe"
}
}
],
"transactions": [
{
"id": "cmr3f41z20001psp7phmyapw3",
"toAddress": "123 Main St",
"amount": "example_string",
"asset": "example_string",
"network": "example_string",
"status": "confirmed",
"txHash": "example_string",
"fee": "example_string",
"failureReason": "example_string",
"createdAt": "2026-07-02T11:25:15.134000Z",
"confirmedAt": "2026-07-02T11:25:15.134000Z",
"decisionPolicyCode": "example_string",
"amountDecimal": "1.5",
"assetSymbol": "USDT"
}
],
"incomingTransactions": [
{
"id": "cmr3f41z20001psp7phmyapw3",
"fromExternal": "example_string",
"amount": "example_string",
"asset": "example_string",
"network": "example_string",
"txHash": "example_string",
"block": 42,
"timestamp": "example_string",
"createdAt": "2026-07-02T11:25:15.134000Z",
"amountDecimal": "1.5",
"assetSymbol": "USDT"
}
]
}
{
"error": "Unauthorized",
"message": "Authentication required. Please provide a valid API token",
"code": 401
}
{
"error": "Not Found",
"message": "The requested resource was not found",
"code": 404
}
{
"error": "Internal Server Error",
"message": "An unexpected error occurred on the server",
"code": 500,
"requestId": "req_1234567890"
}
/api/v1/vaults/{code}/addresses/{id}Target server for requests. Edit to use your own host.
Session token. Mobile/services. The web uses a cookie.
API key (sent in cookie)
Unique Vault code (slug)
Address id (cuid)
Request Preview
Response
Response will appear here after sending the request
Authentication
Bearer token. Session token. Mobile/services. The web uses a cookie.
API Key for authentication. Provide your API key in the cookie.
Path Parameters
Address id (cuid)
Responses
cuid
On-chain address from Wallet Service
Dynamic segment value (incrementing)
Segment code → pathId (excluding network and index)
Link to the address's logo image
HEX color
Emoji icon
raw smallest units
Balances for ALL of the address's tokens, from the ledger, the single source of truth. A token with no ledger account isn't included: "zero" and "this token was never here" are different facts
Denormalized address asset: FK to Token (from the path's asset segment)
Address token code (from segmentsJson + asset route)
Balance in decimal (by token.decimals)
Address owner (legacy; no email). The canonical one is owner below
Address owner with UI metadata (for the "whose address" avatar)
The current user's permissions on this address
Who has access to the address (people/groups, direct and via an address group). Visible to anyone with view access.
Last 20 outgoing
Last 20 incoming