Address book

Save wallet details

Save ownership and custody details for a wallet.

POST
/api/v2/address-book

Appends an immutable wallet declaration. Known third-party facts can be partial. This does not whitelist the wallet.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://compose.finance/api/v2/address-book" \  -H "Content-Type: application/json" \  -d '{    "network": "base",    "address": "string",    "direction": "INBOUND",    "wallet": {      "owner": {        "party": "ORGANIZATION"      }    }  }'
{
  "id": "string",
  "declarationId": "string"
}
{
  "error": "Invalid declaration"
}
{
  "error": "Unauthorized - Invalid or missing API key or session"
}

{
  "error": "An enabled organization member is required"
}

{
  "error": "Not found in this organization"
}
{
  "error": "Revision conflict: reload before correcting"
}
{
  "error": "Rate limit exceeded. Please try again later."
}

{
  "error": "Internal server error"
}

{
  "error": "Verified identity is temporarily unavailable. Try again in a few minutes."
}