---
title: "List Contacts"
method: GET
path: "/api/v1/addressbook/contacts"
tags: ["Address Book"]
---

# List Contacts

`GET /api/v1/addressbook/contacts`

Get a list of all contacts in an organization.

## Query parameters

- `sort_by` ContactSortableFields[]
- `page` integer — The page number to fetch.
- `size` integer — The number of items per page.
- `skip_count` boolean — Whether to skip counting the total number of items.
- `contact_ids` string[] — The contact IDs to filter by.
- `names` string[] — The names to filter by.
- `states` AddressBookContactState[] — The states to filter by.
- `chain_types` ChainType[] — The chain types to filter by.
- `chains` string[] — The chain unique ids to filter by.
- `asset_ids` string[] — List of asset identifiers to filter on.
- `address_group_ids` string[] — The address group IDs to filter by.
- `exclude_address_group_ids` string[] — List of address group IDs to exclude.
- `exclude_contact_ids` string[] — List of contact IDs to exclude.

## Response `200`

Successful Response

- ListAddressBookContactResponse
  - `total` integer, required
  - `page` integer, required
  - `size` integer, required
  - `contacts` AddressBookContact[], required
    - union — Represents a contact in the Fordefi platform
      - AptosAddressBookContact — Represents a contact in the Fordefi platform
        - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform.
        - `created_at` string, date-time, required — The date and time when the object was created.
        - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification.
        - `name` string, required — The name of the contact.
        - `modified_by` union, required — Represents a reference to a user in the Fordefi platform
          - PersonRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'person', required — The type of user. Can be a person, or (in programmatic scenarios) an API user or API Signer.
            - `name` string — The name of the user.
            - `email` string, required — The email of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'reset_device_pending_code_generation' | 'reset_device_pending_activation' | 'pending_approval' | 'deleted', required
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_user', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiSignerRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_signer', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'deleted', required — The state of the user.
          - EndUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'end_user', required — The type of the user.
            - `external_id` string, required — External id of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
          - SystemUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'system', required — The type of the user.
            - `name` string, required — The name is Fordefi CARE
        - `state` 'pending' | 'active' | 'deleted', required
        - `groups` GroupRef[], required — List of contact's groups.
          - `id` string, uuid, required — The unique identifier of the address book group in the Fordefi platform.
          - `name` string, required — The name of the group.
          - `contacts_count` integer, required — The number of contacts in the group.
        - `pending_changes` AddressBookContactChanges — Represents pending changes for a contact in the Fordefi platform
          - `is_being_edited` boolean — `True` if the contact is being edited, `False` otherwise.
          - `change_request_id` string, uuid — The change request ID of the contact.
          - `change_request_reason` 'creation' | 'modification', required
          - `batch_size` integer, required — The number of contacts in the change request.
        - `asset_infos` AssetInfo[], required — A list of asset infos for the contact. Can be used to enforce trading of specific assets intransfers to this address
          - `id` string, uuid, required — The asset ID.
          - `asset_identifier` union, required
            - AptosAssetIdentifier
              - …
            - ArchAssetIdentifier
              - …
            - CantonAssetIdentifier
              - …
            - CosmosAssetIdentifier
              - …
            - EvmAssetIdentifier
              - …
            - ExchangeAssetIdentifier
              - …
            - SolanaAssetIdentifier
              - …
            - StacksAssetIdentifier
              - …
            - StellarAssetIdentifier
              - …
            - StarknetAssetIdentifier
              - …
            - SuiAssetIdentifier
              - …
            - TonAssetIdentifier
              - …
            - TronAssetIdentifier
              - …
            - UtxoAssetIdentifier
              - …
          - `name` string, required — The name of the asset.
          - `symbol` string, required — The symbol (ticker) of the asset.
          - `decimals` integer, required
          - `verified` boolean, required — `True` if this asset is verified by Fordefi, `False` otherwise.
          - `metadata_uri` string — The URI of the asset metadata.
          - `is_spam` boolean, required — `True` if this asset is spam, `False` otherwise.
          - `logo_url` string, uri — The URL of the asset logo.
          - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the asset.
          - `issuer_name` string — Best-effort display name of the issuer
        - `chain_type` 'aptos', required — The type of the chain.
        - `address` string, required — The address on the aptos chain.
        - `chains` EnrichedAptosChain[], required — The chains the contact belongs to. If empty, the contact is associated with all chains.
          - `chain_type` 'aptos', required — The type of the chain.
          - `unique_id` 'aptos_mainnet' | 'aptos_testnet' | 'aptos_movement_mainnet' | 'aptos_movement_testnet', required
          - `name` string, required — The full blockchain name.
          - `native_currency_symbol` string, required — The native currency symbol.
          - `native_currency_name` string, required — The native currency name.
          - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point.
            - `transaction_url` string, uri, required
            - `address_url` string, uri, required
            - `root_url` string, uri, required
            - `transaction_format_url` string, uri
            - `address_format_url` string, uri
            - `asset_format_url` string, uri
          - `logo_url` string, uri, required — The logo URL of the chain.
          - `is_testnet` boolean, required — Whether the chain is on a testnet.
          - `is_enabled` boolean, required — Whether the chain is enabled.
      - ArchAddressBookContact — Represents a contact in the Fordefi platform
        - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform.
        - `created_at` string, date-time, required — The date and time when the object was created.
        - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification.
        - `name` string, required — The name of the contact.
        - `modified_by` union, required — Represents a reference to a user in the Fordefi platform
          - PersonRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'person', required — The type of user. Can be a person, or (in programmatic scenarios) an API user or API Signer.
            - `name` string — The name of the user.
            - `email` string, required — The email of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'reset_device_pending_code_generation' | 'reset_device_pending_activation' | 'pending_approval' | 'deleted', required
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_user', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiSignerRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_signer', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'deleted', required — The state of the user.
          - EndUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'end_user', required — The type of the user.
            - `external_id` string, required — External id of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
          - SystemUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'system', required — The type of the user.
            - `name` string, required — The name is Fordefi CARE
        - `state` 'pending' | 'active' | 'deleted', required
        - `groups` GroupRef[], required — List of contact's groups.
          - `id` string, uuid, required — The unique identifier of the address book group in the Fordefi platform.
          - `name` string, required — The name of the group.
          - `contacts_count` integer, required — The number of contacts in the group.
        - `pending_changes` AddressBookContactChanges — Represents pending changes for a contact in the Fordefi platform
          - `is_being_edited` boolean — `True` if the contact is being edited, `False` otherwise.
          - `change_request_id` string, uuid — The change request ID of the contact.
          - `change_request_reason` 'creation' | 'modification', required
          - `batch_size` integer, required — The number of contacts in the change request.
        - `asset_infos` AssetInfo[], required — A list of asset infos for the contact. Can be used to enforce trading of specific assets intransfers to this address
          - `id` string, uuid, required — The asset ID.
          - `asset_identifier` union, required
            - AptosAssetIdentifier
              - …
            - ArchAssetIdentifier
              - …
            - CantonAssetIdentifier
              - …
            - CosmosAssetIdentifier
              - …
            - EvmAssetIdentifier
              - …
            - ExchangeAssetIdentifier
              - …
            - SolanaAssetIdentifier
              - …
            - StacksAssetIdentifier
              - …
            - StellarAssetIdentifier
              - …
            - StarknetAssetIdentifier
              - …
            - SuiAssetIdentifier
              - …
            - TonAssetIdentifier
              - …
            - TronAssetIdentifier
              - …
            - UtxoAssetIdentifier
              - …
          - `name` string, required — The name of the asset.
          - `symbol` string, required — The symbol (ticker) of the asset.
          - `decimals` integer, required
          - `verified` boolean, required — `True` if this asset is verified by Fordefi, `False` otherwise.
          - `metadata_uri` string — The URI of the asset metadata.
          - `is_spam` boolean, required — `True` if this asset is spam, `False` otherwise.
          - `logo_url` string, uri — The URL of the asset logo.
          - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the asset.
          - `issuer_name` string — Best-effort display name of the issuer
        - `chain_type` 'arch', required — The type of the chain.
        - `address` string, required — The address on the Arch chain.
        - `chains` EnrichedArchChain[], required — The chains the contact belongs to. If empty, the contact is associated with all chains.
          - `chain_type` 'arch', required — The type of the chain.
          - `unique_id` 'arch_mainnet' | 'arch_testnet', required
          - `name` string, required — The full blockchain name.
          - `native_currency_symbol` string, required — The native currency symbol.
          - `native_currency_name` string, required — The native currency name.
          - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point.
            - `transaction_url` string, uri, required
            - `address_url` string, uri, required
            - `root_url` string, uri, required
            - `transaction_format_url` string, uri
            - `address_format_url` string, uri
            - `asset_format_url` string, uri
          - `logo_url` string, uri, required — The logo URL of the chain.
          - `is_testnet` boolean, required — Whether the chain is on a testnet.
          - `is_enabled` boolean, required — Whether the chain is enabled.
      - CantonAddressBookContact — Represents a contact in the Fordefi platform
        - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform.
        - `created_at` string, date-time, required — The date and time when the object was created.
        - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification.
        - `name` string, required — The name of the contact.
        - `modified_by` union, required — Represents a reference to a user in the Fordefi platform
          - PersonRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'person', required — The type of user. Can be a person, or (in programmatic scenarios) an API user or API Signer.
            - `name` string — The name of the user.
            - `email` string, required — The email of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'reset_device_pending_code_generation' | 'reset_device_pending_activation' | 'pending_approval' | 'deleted', required
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_user', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiSignerRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_signer', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'deleted', required — The state of the user.
          - EndUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'end_user', required — The type of the user.
            - `external_id` string, required — External id of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
          - SystemUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'system', required — The type of the user.
            - `name` string, required — The name is Fordefi CARE
        - `state` 'pending' | 'active' | 'deleted', required
        - `groups` GroupRef[], required — List of contact's groups.
          - `id` string, uuid, required — The unique identifier of the address book group in the Fordefi platform.
          - `name` string, required — The name of the group.
          - `contacts_count` integer, required — The number of contacts in the group.
        - `pending_changes` AddressBookContactChanges — Represents pending changes for a contact in the Fordefi platform
          - `is_being_edited` boolean — `True` if the contact is being edited, `False` otherwise.
          - `change_request_id` string, uuid — The change request ID of the contact.
          - `change_request_reason` 'creation' | 'modification', required
          - `batch_size` integer, required — The number of contacts in the change request.
        - `asset_infos` AssetInfo[], required — A list of asset infos for the contact. Can be used to enforce trading of specific assets intransfers to this address
          - `id` string, uuid, required — The asset ID.
          - `asset_identifier` union, required
            - AptosAssetIdentifier
              - …
            - ArchAssetIdentifier
              - …
            - CantonAssetIdentifier
              - …
            - CosmosAssetIdentifier
              - …
            - EvmAssetIdentifier
              - …
            - ExchangeAssetIdentifier
              - …
            - SolanaAssetIdentifier
              - …
            - StacksAssetIdentifier
              - …
            - StellarAssetIdentifier
              - …
            - StarknetAssetIdentifier
              - …
            - SuiAssetIdentifier
              - …
            - TonAssetIdentifier
              - …
            - TronAssetIdentifier
              - …
            - UtxoAssetIdentifier
              - …
          - `name` string, required — The name of the asset.
          - `symbol` string, required — The symbol (ticker) of the asset.
          - `decimals` integer, required
          - `verified` boolean, required — `True` if this asset is verified by Fordefi, `False` otherwise.
          - `metadata_uri` string — The URI of the asset metadata.
          - `is_spam` boolean, required — `True` if this asset is spam, `False` otherwise.
          - `logo_url` string, uri — The URL of the asset logo.
          - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the asset.
          - `issuer_name` string — Best-effort display name of the issuer
        - `chain_type` 'canton', required — The type of the chain.
        - `address` string, required — The party id on the Canton chain.
        - `chains` EnrichedCantonChain[], required — The chains the contact belongs to. If empty, the contact is associated with all chains.
          - `chain_type` 'canton', required — The type of the chain.
          - `unique_id` 'canton_mainnet' | 'canton_testnet', required
          - `name` string, required — The full blockchain name.
          - `native_currency_symbol` string, required — The native currency symbol.
          - `native_currency_name` string, required — The native currency name.
          - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point.
            - `transaction_url` string, uri, required
            - `address_url` string, uri, required
            - `root_url` string, uri, required
            - `transaction_format_url` string, uri
            - `address_format_url` string, uri
            - `asset_format_url` string, uri
          - `logo_url` string, uri, required — The logo URL of the chain.
          - `is_testnet` boolean, required — Whether the chain is on a testnet.
          - `is_enabled` boolean, required — Whether the chain is enabled.
        - `memo` string — Memo is an additional address feature used for identifying a recipient.
      - CosmosAddressBookContact — Represents a contact in the Fordefi platform
        - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform.
        - `created_at` string, date-time, required — The date and time when the object was created.
        - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification.
        - `name` string, required — The name of the contact.
        - `modified_by` union, required — Represents a reference to a user in the Fordefi platform
          - PersonRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'person', required — The type of user. Can be a person, or (in programmatic scenarios) an API user or API Signer.
            - `name` string — The name of the user.
            - `email` string, required — The email of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'reset_device_pending_code_generation' | 'reset_device_pending_activation' | 'pending_approval' | 'deleted', required
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_user', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiSignerRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_signer', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'deleted', required — The state of the user.
          - EndUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'end_user', required — The type of the user.
            - `external_id` string, required — External id of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
          - SystemUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'system', required — The type of the user.
            - `name` string, required — The name is Fordefi CARE
        - `state` 'pending' | 'active' | 'deleted', required
        - `groups` GroupRef[], required — List of contact's groups.
          - `id` string, uuid, required — The unique identifier of the address book group in the Fordefi platform.
          - `name` string, required — The name of the group.
          - `contacts_count` integer, required — The number of contacts in the group.
        - `pending_changes` AddressBookContactChanges — Represents pending changes for a contact in the Fordefi platform
          - `is_being_edited` boolean — `True` if the contact is being edited, `False` otherwise.
          - `change_request_id` string, uuid — The change request ID of the contact.
          - `change_request_reason` 'creation' | 'modification', required
          - `batch_size` integer, required — The number of contacts in the change request.
        - `asset_infos` AssetInfo[], required — A list of asset infos for the contact. Can be used to enforce trading of specific assets intransfers to this address
          - `id` string, uuid, required — The asset ID.
          - `asset_identifier` union, required
            - AptosAssetIdentifier
              - …
            - ArchAssetIdentifier
              - …
            - CantonAssetIdentifier
              - …
            - CosmosAssetIdentifier
              - …
            - EvmAssetIdentifier
              - …
            - ExchangeAssetIdentifier
              - …
            - SolanaAssetIdentifier
              - …
            - StacksAssetIdentifier
              - …
            - StellarAssetIdentifier
              - …
            - StarknetAssetIdentifier
              - …
            - SuiAssetIdentifier
              - …
            - TonAssetIdentifier
              - …
            - TronAssetIdentifier
              - …
            - UtxoAssetIdentifier
              - …
          - `name` string, required — The name of the asset.
          - `symbol` string, required — The symbol (ticker) of the asset.
          - `decimals` integer, required
          - `verified` boolean, required — `True` if this asset is verified by Fordefi, `False` otherwise.
          - `metadata_uri` string — The URI of the asset metadata.
          - `is_spam` boolean, required — `True` if this asset is spam, `False` otherwise.
          - `logo_url` string, uri — The URL of the asset logo.
          - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the asset.
          - `issuer_name` string — Best-effort display name of the issuer
        - `chain_type` 'cosmos', required — The type of the chain.
        - `address` string, required — The address on the cosmos chain.
        - `chain` EnrichedCosmosChain, required
          - `chain_type` 'cosmos', required — The type of the chain.
          - `unique_id` 'cosmos_agoric-3' | 'cosmos_akashnet-2' | 'cosmos_archway-1' | 'cosmos_axelar-dojo-1' | 'cosmos_bbn-1' | 'cosmos_celestia' | 'cosmos_cosmoshub-4' | 'cosmos_dydx-mainnet-1' | 'cosmos_dydx-testnet-4' | 'cosmos_dymension_1100-1' | 'cosmos_injective-1' | 'cosmos_neutron-1' | 'cosmos_nillion-1' | 'cosmos_noble-1' | 'cosmos_osmosis-1' | 'cosmos_provider' | 'cosmos_ssc-1' | 'cosmos_pacific-1' | 'cosmos_stride-1' | 'cosmos_thorchain-1' | 'cosmos_mantra-1', required
          - `name` string, required — The full blockchain name.
          - `native_currency_symbol` string, required — The native currency symbol.
          - `native_currency_name` string, required — The native currency name.
          - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point.
            - `transaction_url` string, uri, required
            - `address_url` string, uri, required
            - `root_url` string, uri, required
            - `transaction_format_url` string, uri
            - `address_format_url` string, uri
            - `asset_format_url` string, uri
          - `logo_url` string, uri, required — The logo URL of the chain.
          - `is_testnet` boolean, required — Whether the chain is on a testnet.
          - `is_enabled` boolean, required — Whether the chain is enabled.
          - `base_denom` string, required — The base denom of the chain.
          - `bech32_prefix` 'agoric' | 'akash' | 'archway' | 'axelar' | 'bbn' | 'celestia' | 'cosmos' | 'dydx' | 'dym' | 'inj' | 'neutron' | 'nillion' | 'noble' | 'osmo' | 'saga' | 'sei' | 'stride' | 'thor' | 'mantra', required
        - `memo` string — Memo is an additional address feature used for identifying a recipient.
      - EVMAddressBookContact
        - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform.
        - `created_at` string, date-time, required — The date and time when the object was created.
        - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification.
        - `name` string, required — The name of the contact.
        - `modified_by` union, required — Represents a reference to a user in the Fordefi platform
          - PersonRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'person', required — The type of user. Can be a person, or (in programmatic scenarios) an API user or API Signer.
            - `name` string — The name of the user.
            - `email` string, required — The email of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'reset_device_pending_code_generation' | 'reset_device_pending_activation' | 'pending_approval' | 'deleted', required
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_user', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiSignerRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_signer', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'deleted', required — The state of the user.
          - EndUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'end_user', required — The type of the user.
            - `external_id` string, required — External id of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
          - SystemUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'system', required — The type of the user.
            - `name` string, required — The name is Fordefi CARE
        - `state` 'pending' | 'active' | 'deleted', required
        - `groups` GroupRef[], required — List of contact's groups.
          - `id` string, uuid, required — The unique identifier of the address book group in the Fordefi platform.
          - `name` string, required — The name of the group.
          - `contacts_count` integer, required — The number of contacts in the group.
        - `pending_changes` AddressBookContactChanges — Represents pending changes for a contact in the Fordefi platform
          - `is_being_edited` boolean — `True` if the contact is being edited, `False` otherwise.
          - `change_request_id` string, uuid — The change request ID of the contact.
          - `change_request_reason` 'creation' | 'modification', required
          - `batch_size` integer, required — The number of contacts in the change request.
        - `asset_infos` AssetInfo[], required — A list of asset infos for the contact. Can be used to enforce trading of specific assets intransfers to this address
          - `id` string, uuid, required — The asset ID.
          - `asset_identifier` union, required
            - AptosAssetIdentifier
              - …
            - ArchAssetIdentifier
              - …
            - CantonAssetIdentifier
              - …
            - CosmosAssetIdentifier
              - …
            - EvmAssetIdentifier
              - …
            - ExchangeAssetIdentifier
              - …
            - SolanaAssetIdentifier
              - …
            - StacksAssetIdentifier
              - …
            - StellarAssetIdentifier
              - …
            - StarknetAssetIdentifier
              - …
            - SuiAssetIdentifier
              - …
            - TonAssetIdentifier
              - …
            - TronAssetIdentifier
              - …
            - UtxoAssetIdentifier
              - …
          - `name` string, required — The name of the asset.
          - `symbol` string, required — The symbol (ticker) of the asset.
          - `decimals` integer, required
          - `verified` boolean, required — `True` if this asset is verified by Fordefi, `False` otherwise.
          - `metadata_uri` string — The URI of the asset metadata.
          - `is_spam` boolean, required — `True` if this asset is spam, `False` otherwise.
          - `logo_url` string, uri — The URL of the asset logo.
          - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the asset.
          - `issuer_name` string — Best-effort display name of the issuer
        - `chain_type` 'evm', required — The type of the chain.
        - `address` string, required — TThe address of the contact.
        - `chains` EnrichedEvmChain[], required — The chains the contact belongs to. If empty, the contact is associated with all chains.
          - `chain_type` 'evm', required — The type of the chain.
          - `named_chain_id` string — The EVM chain name can be either one of those supported by the default chains below or a custom chain name if one was added to your organization. <ul><li>`arbitrum_mainnet`</li><li>`arbitrum_sepolia`</li><li>`aster_mainnet`</li><li>`avalanche_chain`</li><li>`avalanche_fuji`</li><li>`base_mainnet`</li><li>`berachain_mainnet`</li><li>`blast_mainnet`</li><li>`bsc_mainnet`</li><li>`canto_mainnet`</li><li>`clink_mainnet`</li><li>`clink_testnet`</li><li>`conflux_mainnet`</li><li>`dymension_mainnet`</li><li>`ethereum_goerli`</li><li>`ethereum_holesky`</li><li>`ethereum_mainnet`</li><li>`ethereum_sepolia`</li><li>`fantom_mainnet`</li><li>`flare_mainnet`</li><li>`flare_testnet`</li><li>`gnosis_mainnet`</li><li>`hypercore_mainnet`</li><li>`hyperevm_mainnet`</li><li>`ink_mainnet`</li><li>`kava_mainnet`</li><li>`katana_mainnet`</li><li>`linea_mainnet`</li><li>`optimism_mainnet`</li><li>`pharos_mainnet`</li><li>`plasma_mainnet`</li><li>`manta_pacific_mainnet`</li><li>`mantle_mainnet`</li><li>`merlin_mainnet`</li><li>`monad_mainnet`</li><li>`polygon_mainnet`</li><li>`polygon_mumbai`</li><li>`polygon_zkevm_mainnet`</li><li>`reya_mainnet`</li><li>`robinhood_mainnet`</li><li>`rootstock_mainnet`</li><li>`scroll_mainnet`</li><li>`sei_mainnet`</li><li>`sonic_mainnet`</li><li>`tempo_mainnet`</li><li>`unichain_mainnet`</li><li>`xai_mainnet`</li><li>`x_layer_mainnet`</li><li>`zero_gravity_mainnet`</li><li>`zeta_mainnet`</li><li>`zklink_nova_mainnet`</li><li>`zksync_era_mainnet`</li></ul>
          - `chain_id` integer, required — The EVM chain ID can be either one of those supported by the default chains below or a custom chain ID if one was added to your organization. <ul><li>1=`ethereum_mainnet`</li><li>5=`ethereum_goerli`</li><li>10=`optimism_mainnet`</li><li>14=`flare_mainnet`</li><li>16=`flare_testnet`</li><li>30=`rootstock_mainnet`</li><li>56=`bsc_mainnet`</li><li>100=`gnosis_mainnet`</li><li>130=`unichain_mainnet`</li><li>137=`polygon_mainnet`</li><li>143=`monad_mainnet`</li><li>146=`sonic_mainnet`</li><li>169=`manta_pacific_mainnet`</li><li>196=`x_layer_mainnet`</li><li>250=`fantom_mainnet`</li><li>324=`zksync_era_mainnet`</li><li>999=`hyperevm_mainnet`</li><li>1030=`conflux_mainnet`</li><li>1100=`dymension_mainnet`</li><li>1101=`polygon_zkevm_mainnet`</li><li>1329=`sei_mainnet`</li><li>1337=`hypercore_mainnet`</li><li>1666=`aster_mainnet`</li><li>1672=`pharos_mainnet`</li><li>1729=`reya_mainnet`</li><li>2222=`kava_mainnet`</li><li>4200=`merlin_mainnet`</li><li>4217=`tempo_mainnet`</li><li>4663=`robinhood_mainnet`</li><li>5000=`mantle_mainnet`</li><li>7000=`zeta_mainnet`</li><li>7700=`canto_mainnet`</li><li>8453=`base_mainnet`</li><li>8818=`clink_mainnet`</li><li>8819=`clink_testnet`</li><li>9745=`plasma_mainnet`</li><li>16661=`zero_gravity_mainnet`</li><li>17000=`ethereum_holesky`</li><li>80001=`polygon_mumbai`</li><li>80094=`berachain_mainnet`</li><li>42161=`arbitrum_mainnet`</li><li>43113=`avalanche_fuji`</li><li>43114=`avalanche_chain`</li><li>57073=`ink_mainnet`</li><li>59144=`linea_mainnet`</li><li>81457=`blast_mainnet`</li><li>421614=`arbitrum_sepolia`</li><li>534352=`scroll_mainnet`</li><li>660279=`xai_mainnet`</li><li>747474=`katana_mainnet`</li><li>810180=`zklink_nova_mainnet`</li><li>11155111=`ethereum_sepolia`</li></ul>
          - `unique_id` string, required — The unique EVM chain ID. </br>Can be either one of those supported by the default chains below or a custom numeric chain ID `evm_<numeric_chain_id>` if one was added to your organization. <ul><li>`"evm_1"`</li><li>`"evm_5"`</li><li>`"evm_10"`</li><li>`"evm_14"`</li><li>`"evm_16"`</li><li>`"evm_30"`</li><li>`"evm_56"`</li><li>`"evm_100"`</li><li>`"evm_130"`</li><li>`"evm_137"`</li><li>`"evm_143"`</li><li>`"evm_146"`</li><li>`"evm_169"`</li><li>`"evm_196"`</li><li>`"evm_250"`</li><li>`"evm_324"`</li><li>`"evm_999"`</li><li>`"evm_1030"`</li><li>`"evm_1100"`</li><li>`"evm_1101"`</li><li>`"evm_1329"`</li><li>`"evm_1337"`</li><li>`"evm_1666"`</li><li>`"evm_1672"`</li><li>`"evm_1729"`</li><li>`"evm_2222"`</li><li>`"evm_4200"`</li><li>`"evm_4217"`</li><li>`"evm_4663"`</li><li>`"evm_5000"`</li><li>`"evm_7000"`</li><li>`"evm_7700"`</li><li>`"evm_8453"`</li><li>`"evm_8818"`</li><li>`"evm_8819"`</li><li>`"evm_9745"`</li><li>`"evm_16661"`</li><li>`"evm_17000"`</li><li>`"evm_80001"`</li><li>`"evm_80094"`</li><li>`"evm_42161"`</li><li>`"evm_43113"`</li><li>`"evm_43114"`</li><li>`"evm_57073"`</li><li>`"evm_59144"`</li><li>`"evm_81457"`</li><li>`"evm_421614"`</li><li>`"evm_534352"`</li><li>`"evm_660279"`</li><li>`"evm_747474"`</li><li>`"evm_810180"`</li><li>`"evm_11155111"`</li><li>`"evm_ethereum_mainnet"`</li><li>`"evm_ethereum_goerli"`</li><li>`"evm_optimism_mainnet"`</li><li>`"evm_flare_mainnet"`</li><li>`"evm_flare_testnet"`</li><li>`"evm_rootstock_mainnet"`</li><li>`"evm_bsc_mainnet"`</li><li>`"evm_gnosis_mainnet"`</li><li>`"evm_unichain_mainnet"`</li><li>`"evm_polygon_mainnet"`</li><li>`"evm_monad_mainnet"`</li><li>`"evm_sonic_mainnet"`</li><li>`"evm_manta_pacific_mainnet"`</li><li>`"evm_x_layer_mainnet"`</li><li>`"evm_fantom_mainnet"`</li><li>`"evm_zksync_era_mainnet"`</li><li>`"evm_hyperevm_mainnet"`</li><li>`"evm_conflux_mainnet"`</li><li>`"evm_dymension_mainnet"`</li><li>`"evm_polygon_zkevm_mainnet"`</li><li>`"evm_sei_mainnet"`</li><li>`"evm_hypercore_mainnet"`</li><li>`"evm_aster_mainnet"`</li><li>`"evm_pharos_mainnet"`</li><li>`"evm_reya_mainnet"`</li><li>`"evm_kava_mainnet"`</li><li>`"evm_merlin_mainnet"`</li><li>`"evm_tempo_mainnet"`</li><li>`"evm_robinhood_mainnet"`</li><li>`"evm_mantle_mainnet"`</li><li>`"evm_zeta_mainnet"`</li><li>`"evm_canto_mainnet"`</li><li>`"evm_base_mainnet"`</li><li>`"evm_clink_mainnet"`</li><li>`"evm_clink_testnet"`</li><li>`"evm_plasma_mainnet"`</li><li>`"evm_zero_gravity_mainnet"`</li><li>`"evm_ethereum_holesky"`</li><li>`"evm_polygon_mumbai"`</li><li>`"evm_berachain_mainnet"`</li><li>`"evm_arbitrum_mainnet"`</li><li>`"evm_avalanche_fuji"`</li><li>`"evm_avalanche_chain"`</li><li>`"evm_ink_mainnet"`</li><li>`"evm_linea_mainnet"`</li><li>`"evm_blast_mainnet"`</li><li>`"evm_arbitrum_sepolia"`</li><li>`"evm_scroll_mainnet"`</li><li>`"evm_xai_mainnet"`</li><li>`"evm_katana_mainnet"`</li><li>`"evm_zklink_nova_mainnet"`</li><li>`"evm_ethereum_sepolia"`</li></ul>
          - `name` string, required — The full blockchain name.
          - `native_currency_symbol` string, required — The native currency symbol.
          - `native_currency_name` string, required — The native currency name.
          - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point.
            - `transaction_url` string, uri, required
            - `address_url` string, uri, required
            - `root_url` string, uri, required
            - `transaction_format_url` string, uri
            - `address_format_url` string, uri
            - `asset_format_url` string, uri
          - `logo_url` string, uri, required — The logo URL of the chain.
          - `is_testnet` boolean, required — Whether the chain is on a testnet.
          - `is_enabled` boolean, required — Whether the chain is enabled.
          - `gas_type` 'dynamic' | 'legacy', required
          - `supports_secure_node` boolean — `True` if the chain supports secure nodes, `False` otherwise.
          - `supports_mev_protected_node` boolean — `True` if the chain supports MEV protected nodes, `False` otherwise.
          - `rpc_url` string — The URL of the chain's RPC. Exists only for custom chains.
          - `source` 'default' | 'custom', required
          - `supports_7702` boolean — `True` if the chain supports 7702, `False` otherwise.
      - SolanaAddressBookContact — Represents a contact in the Fordefi platform
        - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform.
        - `created_at` string, date-time, required — The date and time when the object was created.
        - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification.
        - `name` string, required — The name of the contact.
        - `modified_by` union, required — Represents a reference to a user in the Fordefi platform
          - PersonRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'person', required — The type of user. Can be a person, or (in programmatic scenarios) an API user or API Signer.
            - `name` string — The name of the user.
            - `email` string, required — The email of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'reset_device_pending_code_generation' | 'reset_device_pending_activation' | 'pending_approval' | 'deleted', required
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_user', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiSignerRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_signer', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'deleted', required — The state of the user.
          - EndUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'end_user', required — The type of the user.
            - `external_id` string, required — External id of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
          - SystemUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'system', required — The type of the user.
            - `name` string, required — The name is Fordefi CARE
        - `state` 'pending' | 'active' | 'deleted', required
        - `groups` GroupRef[], required — List of contact's groups.
          - `id` string, uuid, required — The unique identifier of the address book group in the Fordefi platform.
          - `name` string, required — The name of the group.
          - `contacts_count` integer, required — The number of contacts in the group.
        - `pending_changes` AddressBookContactChanges — Represents pending changes for a contact in the Fordefi platform
          - `is_being_edited` boolean — `True` if the contact is being edited, `False` otherwise.
          - `change_request_id` string, uuid — The change request ID of the contact.
          - `change_request_reason` 'creation' | 'modification', required
          - `batch_size` integer, required — The number of contacts in the change request.
        - `asset_infos` AssetInfo[], required — A list of asset infos for the contact. Can be used to enforce trading of specific assets intransfers to this address
          - `id` string, uuid, required — The asset ID.
          - `asset_identifier` union, required
            - AptosAssetIdentifier
              - …
            - ArchAssetIdentifier
              - …
            - CantonAssetIdentifier
              - …
            - CosmosAssetIdentifier
              - …
            - EvmAssetIdentifier
              - …
            - ExchangeAssetIdentifier
              - …
            - SolanaAssetIdentifier
              - …
            - StacksAssetIdentifier
              - …
            - StellarAssetIdentifier
              - …
            - StarknetAssetIdentifier
              - …
            - SuiAssetIdentifier
              - …
            - TonAssetIdentifier
              - …
            - TronAssetIdentifier
              - …
            - UtxoAssetIdentifier
              - …
          - `name` string, required — The name of the asset.
          - `symbol` string, required — The symbol (ticker) of the asset.
          - `decimals` integer, required
          - `verified` boolean, required — `True` if this asset is verified by Fordefi, `False` otherwise.
          - `metadata_uri` string — The URI of the asset metadata.
          - `is_spam` boolean, required — `True` if this asset is spam, `False` otherwise.
          - `logo_url` string, uri — The URL of the asset logo.
          - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the asset.
          - `issuer_name` string — Best-effort display name of the issuer
        - `chain_type` 'solana', required — The type of the chain.
        - `address` string, required — The address on the solana chain.
        - `chains` EnrichedSolanaChain[], required — The chains the contact belongs to. If empty, the contact is associated with all chains.
          - `chain_type` 'solana', required — The type of the chain.
          - `unique_id` 'solana_mainnet' | 'solana_devnet' | 'solana_eclipse_mainnet' | 'solana_fogo_mainnet' | 'solana_fogo_testnet', required
          - `name` string, required — The full blockchain name.
          - `native_currency_symbol` string, required — The native currency symbol.
          - `native_currency_name` string, required — The native currency name.
          - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point.
            - `transaction_url` string, uri, required
            - `address_url` string, uri, required
            - `root_url` string, uri, required
            - `transaction_format_url` string, uri
            - `address_format_url` string, uri
            - `asset_format_url` string, uri
          - `logo_url` string, uri, required — The logo URL of the chain.
          - `is_testnet` boolean, required — Whether the chain is on a testnet.
          - `is_enabled` boolean, required — Whether the chain is enabled.
      - StacksAddressBookContact — Represents a contact in the Fordefi platform
        - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform.
        - `created_at` string, date-time, required — The date and time when the object was created.
        - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification.
        - `name` string, required — The name of the contact.
        - `modified_by` union, required — Represents a reference to a user in the Fordefi platform
          - PersonRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'person', required — The type of user. Can be a person, or (in programmatic scenarios) an API user or API Signer.
            - `name` string — The name of the user.
            - `email` string, required — The email of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'reset_device_pending_code_generation' | 'reset_device_pending_activation' | 'pending_approval' | 'deleted', required
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_user', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiSignerRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_signer', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'deleted', required — The state of the user.
          - EndUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'end_user', required — The type of the user.
            - `external_id` string, required — External id of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
          - SystemUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'system', required — The type of the user.
            - `name` string, required — The name is Fordefi CARE
        - `state` 'pending' | 'active' | 'deleted', required
        - `groups` GroupRef[], required — List of contact's groups.
          - `id` string, uuid, required — The unique identifier of the address book group in the Fordefi platform.
          - `name` string, required — The name of the group.
          - `contacts_count` integer, required — The number of contacts in the group.
        - `pending_changes` AddressBookContactChanges — Represents pending changes for a contact in the Fordefi platform
          - `is_being_edited` boolean — `True` if the contact is being edited, `False` otherwise.
          - `change_request_id` string, uuid — The change request ID of the contact.
          - `change_request_reason` 'creation' | 'modification', required
          - `batch_size` integer, required — The number of contacts in the change request.
        - `asset_infos` AssetInfo[], required — A list of asset infos for the contact. Can be used to enforce trading of specific assets intransfers to this address
          - `id` string, uuid, required — The asset ID.
          - `asset_identifier` union, required
            - AptosAssetIdentifier
              - …
            - ArchAssetIdentifier
              - …
            - CantonAssetIdentifier
              - …
            - CosmosAssetIdentifier
              - …
            - EvmAssetIdentifier
              - …
            - ExchangeAssetIdentifier
              - …
            - SolanaAssetIdentifier
              - …
            - StacksAssetIdentifier
              - …
            - StellarAssetIdentifier
              - …
            - StarknetAssetIdentifier
              - …
            - SuiAssetIdentifier
              - …
            - TonAssetIdentifier
              - …
            - TronAssetIdentifier
              - …
            - UtxoAssetIdentifier
              - …
          - `name` string, required — The name of the asset.
          - `symbol` string, required — The symbol (ticker) of the asset.
          - `decimals` integer, required
          - `verified` boolean, required — `True` if this asset is verified by Fordefi, `False` otherwise.
          - `metadata_uri` string — The URI of the asset metadata.
          - `is_spam` boolean, required — `True` if this asset is spam, `False` otherwise.
          - `logo_url` string, uri — The URL of the asset logo.
          - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the asset.
          - `issuer_name` string — Best-effort display name of the issuer
        - `chain_type` 'stacks', required — The type of the chain.
        - `address` string, required — The address on the stacks chain.
        - `chains` EnrichedStacksChain[], required — The chains the contact belongs to. If empty, the contact is associated with all chains.
          - `chain_type` 'stacks', required — The type of the chain.
          - `unique_id` 'stacks_mainnet', required
          - `name` string, required — The full blockchain name.
          - `native_currency_symbol` string, required — The native currency symbol.
          - `native_currency_name` string, required — The native currency name.
          - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point.
            - `transaction_url` string, uri, required
            - `address_url` string, uri, required
            - `root_url` string, uri, required
            - `transaction_format_url` string, uri
            - `address_format_url` string, uri
            - `asset_format_url` string, uri
          - `logo_url` string, uri, required — The logo URL of the chain.
          - `is_testnet` boolean, required — Whether the chain is on a testnet.
          - `is_enabled` boolean, required — Whether the chain is enabled.
        - `memo` string — Memo is an additional address feature used for identifying a recipient.
      - StarknetAddressBookContact — Represents a contact in the Fordefi platform
        - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform.
        - `created_at` string, date-time, required — The date and time when the object was created.
        - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification.
        - `name` string, required — The name of the contact.
        - `modified_by` union, required — Represents a reference to a user in the Fordefi platform
          - PersonRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'person', required — The type of user. Can be a person, or (in programmatic scenarios) an API user or API Signer.
            - `name` string — The name of the user.
            - `email` string, required — The email of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'reset_device_pending_code_generation' | 'reset_device_pending_activation' | 'pending_approval' | 'deleted', required
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_user', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiSignerRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_signer', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'deleted', required — The state of the user.
          - EndUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'end_user', required — The type of the user.
            - `external_id` string, required — External id of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
          - SystemUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'system', required — The type of the user.
            - `name` string, required — The name is Fordefi CARE
        - `state` 'pending' | 'active' | 'deleted', required
        - `groups` GroupRef[], required — List of contact's groups.
          - `id` string, uuid, required — The unique identifier of the address book group in the Fordefi platform.
          - `name` string, required — The name of the group.
          - `contacts_count` integer, required — The number of contacts in the group.
        - `pending_changes` AddressBookContactChanges — Represents pending changes for a contact in the Fordefi platform
          - `is_being_edited` boolean — `True` if the contact is being edited, `False` otherwise.
          - `change_request_id` string, uuid — The change request ID of the contact.
          - `change_request_reason` 'creation' | 'modification', required
          - `batch_size` integer, required — The number of contacts in the change request.
        - `asset_infos` AssetInfo[], required — A list of asset infos for the contact. Can be used to enforce trading of specific assets intransfers to this address
          - `id` string, uuid, required — The asset ID.
          - `asset_identifier` union, required
            - AptosAssetIdentifier
              - …
            - ArchAssetIdentifier
              - …
            - CantonAssetIdentifier
              - …
            - CosmosAssetIdentifier
              - …
            - EvmAssetIdentifier
              - …
            - ExchangeAssetIdentifier
              - …
            - SolanaAssetIdentifier
              - …
            - StacksAssetIdentifier
              - …
            - StellarAssetIdentifier
              - …
            - StarknetAssetIdentifier
              - …
            - SuiAssetIdentifier
              - …
            - TonAssetIdentifier
              - …
            - TronAssetIdentifier
              - …
            - UtxoAssetIdentifier
              - …
          - `name` string, required — The name of the asset.
          - `symbol` string, required — The symbol (ticker) of the asset.
          - `decimals` integer, required
          - `verified` boolean, required — `True` if this asset is verified by Fordefi, `False` otherwise.
          - `metadata_uri` string — The URI of the asset metadata.
          - `is_spam` boolean, required — `True` if this asset is spam, `False` otherwise.
          - `logo_url` string, uri — The URL of the asset logo.
          - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the asset.
          - `issuer_name` string — Best-effort display name of the issuer
        - `chain_type` 'starknet', required — The type of the chain.
        - `address` string, required — The address on the starknet chain.
        - `chains` EnrichedStarknetChain[], required — The chains the contact belongs to. If empty, the contact is associated with all chains.
          - `chain_type` 'starknet', required — The type of the chain.
          - `unique_id` 'starknet_mainnet', required
          - `name` string, required — The full blockchain name.
          - `native_currency_symbol` string, required — The native currency symbol.
          - `native_currency_name` string, required — The native currency name.
          - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point.
            - `transaction_url` string, uri, required
            - `address_url` string, uri, required
            - `root_url` string, uri, required
            - `transaction_format_url` string, uri
            - `address_format_url` string, uri
            - `asset_format_url` string, uri
          - `logo_url` string, uri, required — The logo URL of the chain.
          - `is_testnet` boolean, required — Whether the chain is on a testnet.
          - `is_enabled` boolean, required — Whether the chain is enabled.
      - StellarAddressBookContact — Represents a contact in the Fordefi platform
        - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform.
        - `created_at` string, date-time, required — The date and time when the object was created.
        - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification.
        - `name` string, required — The name of the contact.
        - `modified_by` union, required — Represents a reference to a user in the Fordefi platform
          - PersonRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'person', required — The type of user. Can be a person, or (in programmatic scenarios) an API user or API Signer.
            - `name` string — The name of the user.
            - `email` string, required — The email of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'reset_device_pending_code_generation' | 'reset_device_pending_activation' | 'pending_approval' | 'deleted', required
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_user', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiSignerRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_signer', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'deleted', required — The state of the user.
          - EndUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'end_user', required — The type of the user.
            - `external_id` string, required — External id of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
          - SystemUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'system', required — The type of the user.
            - `name` string, required — The name is Fordefi CARE
        - `state` 'pending' | 'active' | 'deleted', required
        - `groups` GroupRef[], required — List of contact's groups.
          - `id` string, uuid, required — The unique identifier of the address book group in the Fordefi platform.
          - `name` string, required — The name of the group.
          - `contacts_count` integer, required — The number of contacts in the group.
        - `pending_changes` AddressBookContactChanges — Represents pending changes for a contact in the Fordefi platform
          - `is_being_edited` boolean — `True` if the contact is being edited, `False` otherwise.
          - `change_request_id` string, uuid — The change request ID of the contact.
          - `change_request_reason` 'creation' | 'modification', required
          - `batch_size` integer, required — The number of contacts in the change request.
        - `asset_infos` AssetInfo[], required — A list of asset infos for the contact. Can be used to enforce trading of specific assets intransfers to this address
          - `id` string, uuid, required — The asset ID.
          - `asset_identifier` union, required
            - AptosAssetIdentifier
              - …
            - ArchAssetIdentifier
              - …
            - CantonAssetIdentifier
              - …
            - CosmosAssetIdentifier
              - …
            - EvmAssetIdentifier
              - …
            - ExchangeAssetIdentifier
              - …
            - SolanaAssetIdentifier
              - …
            - StacksAssetIdentifier
              - …
            - StellarAssetIdentifier
              - …
            - StarknetAssetIdentifier
              - …
            - SuiAssetIdentifier
              - …
            - TonAssetIdentifier
              - …
            - TronAssetIdentifier
              - …
            - UtxoAssetIdentifier
              - …
          - `name` string, required — The name of the asset.
          - `symbol` string, required — The symbol (ticker) of the asset.
          - `decimals` integer, required
          - `verified` boolean, required — `True` if this asset is verified by Fordefi, `False` otherwise.
          - `metadata_uri` string — The URI of the asset metadata.
          - `is_spam` boolean, required — `True` if this asset is spam, `False` otherwise.
          - `logo_url` string, uri — The URL of the asset logo.
          - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the asset.
          - `issuer_name` string — Best-effort display name of the issuer
        - `chain_type` 'stellar', required — The type of the chain.
        - `address` string, required — The address on the Stellar chain.
        - `chains` EnrichedStellarChain[], required — The chains the contact belongs to. If empty, the contact is associated with all chains.
          - `chain_type` 'stellar', required — The type of the chain.
          - `unique_id` 'stellar_mainnet' | 'stellar_testnet', required
          - `name` string, required — The full blockchain name.
          - `native_currency_symbol` string, required — The native currency symbol.
          - `native_currency_name` string, required — The native currency name.
          - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point.
            - `transaction_url` string, uri, required
            - `address_url` string, uri, required
            - `root_url` string, uri, required
            - `transaction_format_url` string, uri
            - `address_format_url` string, uri
            - `asset_format_url` string, uri
          - `logo_url` string, uri, required — The logo URL of the chain.
          - `is_testnet` boolean, required — Whether the chain is on a testnet.
          - `is_enabled` boolean, required — Whether the chain is enabled.
        - `memo` string — Memo is an additional address feature used for identifying a recipient.
      - SuiAddressBookContact — Represents a contact in the Fordefi platform
        - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform.
        - `created_at` string, date-time, required — The date and time when the object was created.
        - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification.
        - `name` string, required — The name of the contact.
        - `modified_by` union, required — Represents a reference to a user in the Fordefi platform
          - PersonRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'person', required — The type of user. Can be a person, or (in programmatic scenarios) an API user or API Signer.
            - `name` string — The name of the user.
            - `email` string, required — The email of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'reset_device_pending_code_generation' | 'reset_device_pending_activation' | 'pending_approval' | 'deleted', required
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_user', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiSignerRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_signer', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'deleted', required — The state of the user.
          - EndUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'end_user', required — The type of the user.
            - `external_id` string, required — External id of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
          - SystemUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'system', required — The type of the user.
            - `name` string, required — The name is Fordefi CARE
        - `state` 'pending' | 'active' | 'deleted', required
        - `groups` GroupRef[], required — List of contact's groups.
          - `id` string, uuid, required — The unique identifier of the address book group in the Fordefi platform.
          - `name` string, required — The name of the group.
          - `contacts_count` integer, required — The number of contacts in the group.
        - `pending_changes` AddressBookContactChanges — Represents pending changes for a contact in the Fordefi platform
          - `is_being_edited` boolean — `True` if the contact is being edited, `False` otherwise.
          - `change_request_id` string, uuid — The change request ID of the contact.
          - `change_request_reason` 'creation' | 'modification', required
          - `batch_size` integer, required — The number of contacts in the change request.
        - `asset_infos` AssetInfo[], required — A list of asset infos for the contact. Can be used to enforce trading of specific assets intransfers to this address
          - `id` string, uuid, required — The asset ID.
          - `asset_identifier` union, required
            - AptosAssetIdentifier
              - …
            - ArchAssetIdentifier
              - …
            - CantonAssetIdentifier
              - …
            - CosmosAssetIdentifier
              - …
            - EvmAssetIdentifier
              - …
            - ExchangeAssetIdentifier
              - …
            - SolanaAssetIdentifier
              - …
            - StacksAssetIdentifier
              - …
            - StellarAssetIdentifier
              - …
            - StarknetAssetIdentifier
              - …
            - SuiAssetIdentifier
              - …
            - TonAssetIdentifier
              - …
            - TronAssetIdentifier
              - …
            - UtxoAssetIdentifier
              - …
          - `name` string, required — The name of the asset.
          - `symbol` string, required — The symbol (ticker) of the asset.
          - `decimals` integer, required
          - `verified` boolean, required — `True` if this asset is verified by Fordefi, `False` otherwise.
          - `metadata_uri` string — The URI of the asset metadata.
          - `is_spam` boolean, required — `True` if this asset is spam, `False` otherwise.
          - `logo_url` string, uri — The URL of the asset logo.
          - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the asset.
          - `issuer_name` string — Best-effort display name of the issuer
        - `chain_type` 'sui', required — The type of the chain.
        - `address` string, required — The address on the sui chain.
        - `chains` EnrichedSuiChain[], required — The chains the contact belongs to. If empty, the contact is associated with all chains.
          - `chain_type` 'sui', required — The type of the chain.
          - `unique_id` 'sui_mainnet' | 'sui_testnet', required
          - `name` string, required — The full blockchain name.
          - `native_currency_symbol` string, required — The native currency symbol.
          - `native_currency_name` string, required — The native currency name.
          - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point.
            - `transaction_url` string, uri, required
            - `address_url` string, uri, required
            - `root_url` string, uri, required
            - `transaction_format_url` string, uri
            - `address_format_url` string, uri
            - `asset_format_url` string, uri
          - `logo_url` string, uri, required — The logo URL of the chain.
          - `is_testnet` boolean, required — Whether the chain is on a testnet.
          - `is_enabled` boolean, required — Whether the chain is enabled.
      - TonAddressBookContact — Represents a contact in the Fordefi platform
        - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform.
        - `created_at` string, date-time, required — The date and time when the object was created.
        - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification.
        - `name` string, required — The name of the contact.
        - `modified_by` union, required — Represents a reference to a user in the Fordefi platform
          - PersonRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'person', required — The type of user. Can be a person, or (in programmatic scenarios) an API user or API Signer.
            - `name` string — The name of the user.
            - `email` string, required — The email of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'reset_device_pending_code_generation' | 'reset_device_pending_activation' | 'pending_approval' | 'deleted', required
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_user', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiSignerRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_signer', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'deleted', required — The state of the user.
          - EndUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'end_user', required — The type of the user.
            - `external_id` string, required — External id of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
          - SystemUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'system', required — The type of the user.
            - `name` string, required — The name is Fordefi CARE
        - `state` 'pending' | 'active' | 'deleted', required
        - `groups` GroupRef[], required — List of contact's groups.
          - `id` string, uuid, required — The unique identifier of the address book group in the Fordefi platform.
          - `name` string, required — The name of the group.
          - `contacts_count` integer, required — The number of contacts in the group.
        - `pending_changes` AddressBookContactChanges — Represents pending changes for a contact in the Fordefi platform
          - `is_being_edited` boolean — `True` if the contact is being edited, `False` otherwise.
          - `change_request_id` string, uuid — The change request ID of the contact.
          - `change_request_reason` 'creation' | 'modification', required
          - `batch_size` integer, required — The number of contacts in the change request.
        - `asset_infos` AssetInfo[], required — A list of asset infos for the contact. Can be used to enforce trading of specific assets intransfers to this address
          - `id` string, uuid, required — The asset ID.
          - `asset_identifier` union, required
            - AptosAssetIdentifier
              - …
            - ArchAssetIdentifier
              - …
            - CantonAssetIdentifier
              - …
            - CosmosAssetIdentifier
              - …
            - EvmAssetIdentifier
              - …
            - ExchangeAssetIdentifier
              - …
            - SolanaAssetIdentifier
              - …
            - StacksAssetIdentifier
              - …
            - StellarAssetIdentifier
              - …
            - StarknetAssetIdentifier
              - …
            - SuiAssetIdentifier
              - …
            - TonAssetIdentifier
              - …
            - TronAssetIdentifier
              - …
            - UtxoAssetIdentifier
              - …
          - `name` string, required — The name of the asset.
          - `symbol` string, required — The symbol (ticker) of the asset.
          - `decimals` integer, required
          - `verified` boolean, required — `True` if this asset is verified by Fordefi, `False` otherwise.
          - `metadata_uri` string — The URI of the asset metadata.
          - `is_spam` boolean, required — `True` if this asset is spam, `False` otherwise.
          - `logo_url` string, uri — The URL of the asset logo.
          - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the asset.
          - `issuer_name` string — Best-effort display name of the issuer
        - `chain_type` 'ton', required — The type of the chain.
        - `address` string, required — The address on the TON chain.
        - `chains` EnrichedTonChain[], required — The chains the contact belongs to. If empty, the contact is associated with all chains.
          - `chain_type` 'ton', required — The type of the chain.
          - `unique_id` 'ton_mainnet', required
          - `name` string, required — The full blockchain name.
          - `native_currency_symbol` string, required — The native currency symbol.
          - `native_currency_name` string, required — The native currency name.
          - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point.
            - `transaction_url` string, uri, required
            - `address_url` string, uri, required
            - `root_url` string, uri, required
            - `transaction_format_url` string, uri
            - `address_format_url` string, uri
            - `asset_format_url` string, uri
          - `logo_url` string, uri, required — The logo URL of the chain.
          - `is_testnet` boolean, required — Whether the chain is on a testnet.
          - `is_enabled` boolean, required — Whether the chain is enabled.
        - `comment` string — Comment is an additional address feature used for identifying a recipient.
      - TronAddressBookContact — Represents a contact in the Fordefi platform
        - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform.
        - `created_at` string, date-time, required — The date and time when the object was created.
        - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification.
        - `name` string, required — The name of the contact.
        - `modified_by` union, required — Represents a reference to a user in the Fordefi platform
          - PersonRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'person', required — The type of user. Can be a person, or (in programmatic scenarios) an API user or API Signer.
            - `name` string — The name of the user.
            - `email` string, required — The email of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'reset_device_pending_code_generation' | 'reset_device_pending_activation' | 'pending_approval' | 'deleted', required
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_user', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiSignerRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_signer', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'deleted', required — The state of the user.
          - EndUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'end_user', required — The type of the user.
            - `external_id` string, required — External id of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
          - SystemUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'system', required — The type of the user.
            - `name` string, required — The name is Fordefi CARE
        - `state` 'pending' | 'active' | 'deleted', required
        - `groups` GroupRef[], required — List of contact's groups.
          - `id` string, uuid, required — The unique identifier of the address book group in the Fordefi platform.
          - `name` string, required — The name of the group.
          - `contacts_count` integer, required — The number of contacts in the group.
        - `pending_changes` AddressBookContactChanges — Represents pending changes for a contact in the Fordefi platform
          - `is_being_edited` boolean — `True` if the contact is being edited, `False` otherwise.
          - `change_request_id` string, uuid — The change request ID of the contact.
          - `change_request_reason` 'creation' | 'modification', required
          - `batch_size` integer, required — The number of contacts in the change request.
        - `asset_infos` AssetInfo[], required — A list of asset infos for the contact. Can be used to enforce trading of specific assets intransfers to this address
          - `id` string, uuid, required — The asset ID.
          - `asset_identifier` union, required
            - AptosAssetIdentifier
              - …
            - ArchAssetIdentifier
              - …
            - CantonAssetIdentifier
              - …
            - CosmosAssetIdentifier
              - …
            - EvmAssetIdentifier
              - …
            - ExchangeAssetIdentifier
              - …
            - SolanaAssetIdentifier
              - …
            - StacksAssetIdentifier
              - …
            - StellarAssetIdentifier
              - …
            - StarknetAssetIdentifier
              - …
            - SuiAssetIdentifier
              - …
            - TonAssetIdentifier
              - …
            - TronAssetIdentifier
              - …
            - UtxoAssetIdentifier
              - …
          - `name` string, required — The name of the asset.
          - `symbol` string, required — The symbol (ticker) of the asset.
          - `decimals` integer, required
          - `verified` boolean, required — `True` if this asset is verified by Fordefi, `False` otherwise.
          - `metadata_uri` string — The URI of the asset metadata.
          - `is_spam` boolean, required — `True` if this asset is spam, `False` otherwise.
          - `logo_url` string, uri — The URL of the asset logo.
          - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the asset.
          - `issuer_name` string — Best-effort display name of the issuer
        - `chain_type` 'tron', required — The type of the chain.
        - `address` string, required — The address on the TRON chain.
        - `chains` EnrichedTronChain[], required — The chains the contact belongs to. If empty, the contact is associated with all chains.
          - `chain_type` 'tron', required — The type of the chain.
          - `unique_id` 'tron_mainnet' | 'tron_shasta', required
          - `name` string, required — The full blockchain name.
          - `native_currency_symbol` string, required — The native currency symbol.
          - `native_currency_name` string, required — The native currency name.
          - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point.
            - `transaction_url` string, uri, required
            - `address_url` string, uri, required
            - `root_url` string, uri, required
            - `transaction_format_url` string, uri
            - `address_format_url` string, uri
            - `asset_format_url` string, uri
          - `logo_url` string, uri, required — The logo URL of the chain.
          - `is_testnet` boolean, required — Whether the chain is on a testnet.
          - `is_enabled` boolean, required — Whether the chain is enabled.
        - `memo` string — Memo is an additional address feature used for identifying a recipient.
      - UtxoAddressBookContact — Represents a contact in the Fordefi platform
        - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform.
        - `created_at` string, date-time, required — The date and time when the object was created.
        - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification.
        - `name` string, required — The name of the contact.
        - `modified_by` union, required — Represents a reference to a user in the Fordefi platform
          - PersonRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'person', required — The type of user. Can be a person, or (in programmatic scenarios) an API user or API Signer.
            - `name` string — The name of the user.
            - `email` string, required — The email of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'reset_device_pending_code_generation' | 'reset_device_pending_activation' | 'pending_approval' | 'deleted', required
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_user', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
            - `role` 'admin' | 'trader' | 'viewer', required
          - ApiSignerRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'api_signer', required — The type of the user.
            - `name` string, required — The name of the user.
            - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'deleted', required — The state of the user.
          - EndUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'end_user', required — The type of the user.
            - `external_id` string, required — External id of the user.
            - `state` 'active' | 'deleted', required — The state of the user.
          - SystemUserRef
            - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform.
            - `user_type` 'system', required — The type of the user.
            - `name` string, required — The name is Fordefi CARE
        - `state` 'pending' | 'active' | 'deleted', required
        - `groups` GroupRef[], required — List of contact's groups.
          - `id` string, uuid, required — The unique identifier of the address book group in the Fordefi platform.
          - `name` string, required — The name of the group.
          - `contacts_count` integer, required — The number of contacts in the group.
        - `pending_changes` AddressBookContactChanges — Represents pending changes for a contact in the Fordefi platform
          - `is_being_edited` boolean — `True` if the contact is being edited, `False` otherwise.
          - `change_request_id` string, uuid — The change request ID of the contact.
          - `change_request_reason` 'creation' | 'modification', required
          - `batch_size` integer, required — The number of contacts in the change request.
        - `asset_infos` AssetInfo[], required — A list of asset infos for the contact. Can be used to enforce trading of specific assets intransfers to this address
          - `id` string, uuid, required — The asset ID.
          - `asset_identifier` union, required
            - AptosAssetIdentifier
              - …
            - ArchAssetIdentifier
              - …
            - CantonAssetIdentifier
              - …
            - CosmosAssetIdentifier
              - …
            - EvmAssetIdentifier
              - …
            - ExchangeAssetIdentifier
              - …
            - SolanaAssetIdentifier
              - …
            - StacksAssetIdentifier
              - …
            - StellarAssetIdentifier
              - …
            - StarknetAssetIdentifier
              - …
            - SuiAssetIdentifier
              - …
            - TonAssetIdentifier
              - …
            - TronAssetIdentifier
              - …
            - UtxoAssetIdentifier
              - …
          - `name` string, required — The name of the asset.
          - `symbol` string, required — The symbol (ticker) of the asset.
          - `decimals` integer, required
          - `verified` boolean, required — `True` if this asset is verified by Fordefi, `False` otherwise.
          - `metadata_uri` string — The URI of the asset metadata.
          - `is_spam` boolean, required — `True` if this asset is spam, `False` otherwise.
          - `logo_url` string, uri — The URL of the asset logo.
          - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the asset.
          - `issuer_name` string — Best-effort display name of the issuer
        - `chain_type` 'utxo', required — The type of the chain.
        - `address` string, required — The address on the utxo chain.
        - `chain` EnrichedUtxoChain, required
          - `chain_type` 'utxo', required — The type of the chain.
          - `unique_id` 'bitcoin_mainnet' | 'bitcoin_testnet' | 'bitcoin_testnet_v4' | 'dogecoin_mainnet' | 'bitcoin_cash_mainnet' | 'pearl_testnet' | 'pearl_mainnet', required
          - `name` string, required — The full blockchain name.
          - `native_currency_symbol` string, required — The native currency symbol.
          - `native_currency_name` string, required — The native currency name.
          - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point.
            - `transaction_url` string, uri, required
            - `address_url` string, uri, required
            - `root_url` string, uri, required
            - `transaction_format_url` string, uri
            - `address_format_url` string, uri
            - `asset_format_url` string, uri
          - `logo_url` string, uri, required — The logo URL of the chain.
          - `is_testnet` boolean, required — Whether the chain is on a testnet.
          - `is_enabled` boolean, required — Whether the chain is enabled.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized User
- `403` — Forbidden User
- `408` — Request Timeout
- `422` — Validation Error
- `429` — Rate Limit Exceeded
- `500` — Unexpected Error

---

[API](https://skmtc.net/fordefi/apis/fordefi-api.md) · [All operations](https://skmtc.net/fordefi/apis/fordefi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fordefi/fordefi-api/versions/8014fd69ea17/schema)