How to share address book?

Sharing address books has never been easy

Arrange Data

Arrange data in the format

{
    "toId": "string"
    "book": number
    "access": "READ" | "READWRITE"
}

Generate & Sign Message

Call this API to get the message

Generate message for sharing address book

post

Authorizations

Body

idintegerOptional

bookintegerRequired

tostringOptional

accessstring · enumRequiredPossible values:

pendingbooleanOptionalDefault: true

acceptedbooleanOptionalDefault: false

createdAtstring · date-timeOptional

updatedAtstring · date-timeRequired

Responses

200

Successful response

application/json

400Error

application/json

401Error

application/json

post

HTTPcURLJavaScriptPython

POST /v1/address-books/request/message HTTP/1.1
Host: sandbox-api.fetcch.xyz
secret-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 155

{
  "id": 1,
  "book": 1,
  "to": "text",
  "access": "READ",
  "pending": true,
  "accepted": false,
  "createdAt": "2025-05-31T20:29:09.465Z",
  "updatedAt": "2025-05-31T20:29:09.465Z"
}

{
  "data": {
    "message": "text",
    "request": {
      "id": 1,
      "bookId": 1,
      "book": {
        "id": 1,
        "name": "text",
        "addresses": [
          {
            "id": 1,
            "address": "text",
            "chainType": "EVM",
            "name": "text",
            "addressBookId": 1,
            "addressBook": "[Circular Reference]"
          }
        ],
        "walletIds": [
          {
            "id": 1,
            "walletId": "text",
            "wallet": "[Circular Reference]",
            "name": "text",
            "addressBookId": 1,
            "addressBook": "[Circular Reference]",
            "createdAt": "2025-05-31T20:29:09.465Z",
            "updatedAt": "2025-05-31T20:29:09.465Z"
          }
        ],
        "ownerId": "text",
        "owner": {
          "owner": "text",
          "ownerId": "text",
          "ownerIdentity": {
            "id": "text",
            "identifier": "text",
            "providerId": "text",
            "provider": "[Circular Reference]",
            "defaultAddress": "text",
            "default": {
              "address": "text",
              "chain": {
                "id": 1,
                "name": "text",
                "symbol": "text",
                "icon": "text",
                "rpc": [
                  "text"
                ],
                "type": "EVM",
                "shortName": "text",
                "infoURL": "text",
                "chainId": 1,
                "updatedAt": "2025-05-31T20:29:09.465Z",
                "createdAt": "2025-05-31T20:29:09.465Z"
              },
              "chainId": 1,
              "isMultisig": false,
              "isSmartContractWallet": false,
              "walletId": {
                "id": 1,
                "name": "text",
                "symbol": "text",
                "icon": "text",
                "rpc": [
                  "text"
                ],
                "type": "EVM",
                "shortName": "text",
                "infoURL": "text",
                "chainId": 1,
                "updatedAt": "2025-05-31T20:29:09.465Z",
                "createdAt": "2025-05-31T20:29:09.465Z"
              },
              "updatedAt": "2025-05-31T20:29:09.465Z",
              "createdAt": "2025-05-31T20:29:09.465Z"
            },
            "secondary": "[Circular Reference]",
            "nonce": 0,
            "currentSignature": "text",
            "previousSignature": "text",
            "isContract": false,
            "syncedAt": "2025-05-31T20:29:09.465Z",
            "createdAt": "2025-05-31T20:29:09.465Z"
          },
          "createdAt": "2025-05-31T20:29:09.465Z",
          "updatedAt": "2025-05-31T20:29:09.465Z"
        },
        "requests": [
          {
            "id": 1,
            "bookId": 1,
            "book": "[Circular Reference]",
            "toId": "text",
            "to": "[Circular Reference]",
            "access": "READ",
            "pending": true,
            "accepted": false,
            "createdAt": "2025-05-31T20:29:09.465Z",
            "updatedAt": "2025-05-31T20:29:09.465Z"
          }
        ],
        "createdAt": "2025-05-31T20:29:09.465Z",
        "updatedAt": "2025-05-31T20:29:09.465Z"
      },
      "toId": "text",
      "to": {
        "owner": "text",
        "ownerId": "text",
        "ownerIdentity": {
          "id": "text",
          "identifier": "text",
          "providerId": "text",
          "provider": "[Circular Reference]",
          "defaultAddress": "text",
          "default": {
            "address": "text",
            "chain": {
              "id": 1,
              "name": "text",
              "symbol": "text",
              "icon": "text",
              "rpc": [
                "text"
              ],
              "type": "EVM",
              "shortName": "text",
              "infoURL": "text",
              "chainId": 1,
              "updatedAt": "2025-05-31T20:29:09.465Z",
              "createdAt": "2025-05-31T20:29:09.465Z"
            },
            "chainId": 1,
            "isMultisig": false,
            "isSmartContractWallet": false,
            "walletId": {
              "id": 1,
              "name": "text",
              "symbol": "text",
              "icon": "text",
              "rpc": [
                "text"
              ],
              "type": "EVM",
              "shortName": "text",
              "infoURL": "text",
              "chainId": 1,
              "updatedAt": "2025-05-31T20:29:09.465Z",
              "createdAt": "2025-05-31T20:29:09.465Z"
            },
            "updatedAt": "2025-05-31T20:29:09.465Z",
            "createdAt": "2025-05-31T20:29:09.465Z"
          },
          "secondary": "[Circular Reference]",
          "nonce": 0,
          "currentSignature": "text",
          "previousSignature": "text",
          "isContract": false,
          "syncedAt": "2025-05-31T20:29:09.465Z",
          "createdAt": "2025-05-31T20:29:09.465Z"
        },
        "createdAt": "2025-05-31T20:29:09.465Z",
        "updatedAt": "2025-05-31T20:29:09.465Z"
      },
      "access": "READ",
      "pending": true,
      "accepted": false,
      "createdAt": "2025-05-31T20:29:09.465Z",
      "updatedAt": "2025-05-31T20:29:09.465Z"
    }
  },
  "status": 1,
  "timestamp": "2025-05-31T20:29:09.465Z"
}

Sign the above message by following signature guidelines mentioned here according to the chain you are using

Call API

Create address book request

post

Authorizations

Body

idintegerOptional

signaturestringOptional

bookintegerRequired

tostringOptional

accessstring · enumRequiredPossible values:

pendingbooleanOptionalDefault: true

acceptedbooleanOptionalDefault: false

createdAtstring · date-timeOptional

updatedAtstring · date-timeRequired

Responses

200

Successful response

application/json

400Error

application/json

401Error

application/json

post

HTTPcURLJavaScriptPython

POST /v1/address-books/request HTTP/1.1
Host: sandbox-api.fetcch.xyz
secret-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 174

{
  "id": 1,
  "signature": "text",
  "book": 1,
  "to": "text",
  "access": "READ",
  "pending": true,
  "accepted": false,
  "createdAt": "2025-05-31T20:29:09.465Z",
  "updatedAt": "2025-05-31T20:29:09.465Z"
}

{
  "data": {
    "message": "text",
    "request": {
      "id": 1,
      "bookId": 1,
      "book": {
        "id": 1,
        "name": "text",
        "addresses": [
          {
            "id": 1,
            "address": "text",
            "chainType": "EVM",
            "name": "text",
            "addressBookId": 1,
            "addressBook": "[Circular Reference]"
          }
        ],
        "walletIds": [
          {
            "id": 1,
            "walletId": "text",
            "wallet": "[Circular Reference]",
            "name": "text",
            "addressBookId": 1,
            "addressBook": "[Circular Reference]",
            "createdAt": "2025-05-31T20:29:09.465Z",
            "updatedAt": "2025-05-31T20:29:09.465Z"
          }
        ],
        "ownerId": "text",
        "owner": {
          "owner": "text",
          "ownerId": "text",
          "ownerIdentity": {
            "id": "text",
            "identifier": "text",
            "providerId": "text",
            "provider": "[Circular Reference]",
            "defaultAddress": "text",
            "default": {
              "address": "text",
              "chain": {
                "id": 1,
                "name": "text",
                "symbol": "text",
                "icon": "text",
                "rpc": [
                  "text"
                ],
                "type": "EVM",
                "shortName": "text",
                "infoURL": "text",
                "chainId": 1,
                "updatedAt": "2025-05-31T20:29:09.465Z",
                "createdAt": "2025-05-31T20:29:09.465Z"
              },
              "chainId": 1,
              "isMultisig": false,
              "isSmartContractWallet": false,
              "walletId": {
                "id": 1,
                "name": "text",
                "symbol": "text",
                "icon": "text",
                "rpc": [
                  "text"
                ],
                "type": "EVM",
                "shortName": "text",
                "infoURL": "text",
                "chainId": 1,
                "updatedAt": "2025-05-31T20:29:09.465Z",
                "createdAt": "2025-05-31T20:29:09.465Z"
              },
              "updatedAt": "2025-05-31T20:29:09.465Z",
              "createdAt": "2025-05-31T20:29:09.465Z"
            },
            "secondary": "[Circular Reference]",
            "nonce": 0,
            "currentSignature": "text",
            "previousSignature": "text",
            "isContract": false,
            "syncedAt": "2025-05-31T20:29:09.465Z",
            "createdAt": "2025-05-31T20:29:09.465Z"
          },
          "createdAt": "2025-05-31T20:29:09.465Z",
          "updatedAt": "2025-05-31T20:29:09.465Z"
        },
        "requests": [
          {
            "id": 1,
            "bookId": 1,
            "book": "[Circular Reference]",
            "toId": "text",
            "to": "[Circular Reference]",
            "access": "READ",
            "pending": true,
            "accepted": false,
            "createdAt": "2025-05-31T20:29:09.465Z",
            "updatedAt": "2025-05-31T20:29:09.465Z"
          }
        ],
        "createdAt": "2025-05-31T20:29:09.465Z",
        "updatedAt": "2025-05-31T20:29:09.465Z"
      },
      "toId": "text",
      "to": {
        "owner": "text",
        "ownerId": "text",
        "ownerIdentity": {
          "id": "text",
          "identifier": "text",
          "providerId": "text",
          "provider": "[Circular Reference]",
          "defaultAddress": "text",
          "default": {
            "address": "text",
            "chain": {
              "id": 1,
              "name": "text",
              "symbol": "text",
              "icon": "text",
              "rpc": [
                "text"
              ],
              "type": "EVM",
              "shortName": "text",
              "infoURL": "text",
              "chainId": 1,
              "updatedAt": "2025-05-31T20:29:09.465Z",
              "createdAt": "2025-05-31T20:29:09.465Z"
            },
            "chainId": 1,
            "isMultisig": false,
            "isSmartContractWallet": false,
            "walletId": {
              "id": 1,
              "name": "text",
              "symbol": "text",
              "icon": "text",
              "rpc": [
                "text"
              ],
              "type": "EVM",
              "shortName": "text",
              "infoURL": "text",
              "chainId": 1,
              "updatedAt": "2025-05-31T20:29:09.465Z",
              "createdAt": "2025-05-31T20:29:09.465Z"
            },
            "updatedAt": "2025-05-31T20:29:09.465Z",
            "createdAt": "2025-05-31T20:29:09.465Z"
          },
          "secondary": "[Circular Reference]",
          "nonce": 0,
          "currentSignature": "text",
          "previousSignature": "text",
          "isContract": false,
          "syncedAt": "2025-05-31T20:29:09.465Z",
          "createdAt": "2025-05-31T20:29:09.465Z"
        },
        "createdAt": "2025-05-31T20:29:09.465Z",
        "updatedAt": "2025-05-31T20:29:09.465Z"
      },
      "access": "READ",
      "pending": true,
      "accepted": false,
      "createdAt": "2025-05-31T20:29:09.465Z",
      "updatedAt": "2025-05-31T20:29:09.465Z"
    }
  },
  "status": 1,
  "timestamp": "2025-05-31T20:29:09.465Z"
}

Websockets & Webhooks

Coming soon...