---
updatedAt: 2026-04-21T11:22:20.000Z
agentTools:
  projectIndex: https://docs.lmnl.app/v2/llms.txt
---

# Retrieve a list of addresses for consolidation

This API is a request to retrieve a list of addresses for a chain in a deposit wallet which are suitable for consolidation. You can use this API to retrieve a list of addresses for <li>native coins using the `Get-Consolidation-Result-Addresses-Native-Coins-Request` schema. <li> tokens using the `Get-Consolidation-Result-Addresses-Tokens-Request` schema.

While all liminal supported chains support firewall for Mobile MPC Wallets, please refer to the [latest supported chains](https://docs.lmnl.app/v2/reference/firewall-supported-chains-for-v2-wallets) for hot V2 wallets supporting firewall.

<br />

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "API REFERENCES",
    "contact": {},
    "version": "8"
  },
  "servers": [
    {
      "url": "https://api-sdk.lmnl.dev",
      "variables": {}
    }
  ],
  "tags": [
    {
      "name": "Transactions"
    }
  ],
  "paths": {
    "/api/wallet/get-consolidate-transaction": {
      "post": {
        "tags": [
          "Transactions"
        ],
        "summary": "Retrieve a list of addresses for consolidation",
        "description": "This API is a request to retrieve a list of addresses for a chain in a deposit wallet which are suitable for consolidation. You can use this API to retrieve a list of addresses for <li>native coins using the `Get-Consolidation-Result-Addresses-Native-Coins-Request` schema. <li> tokens using the `Get-Consolidation-Result-Addresses-Tokens-Request` schema.",
        "operationId": "GetUnconsolidationTransaction",
        "parameters": [],
        "requestBody": {
          "description": "",
          "content": {
            "application/json": {
              "schema": {
                "oneOf": [
                  {
                    "$ref": "#/components/schemas/Get-Consolidation-Result-Addresses-Native-Coins-Request"
                  },
                  {
                    "$ref": "#/components/schemas/Get-Consolidation-Result-Addresses-Tokens-Request"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json; charset=utf-8": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Get-Consolidation-Results-Success-Response"
                    },
                    {
                      "example": {
                        "success": true,
                        "data": [
                          {
                            "userid": 2428,
                            "raw": "01000204e3b7db6ab538a479dc25caab18a64157a1bc9478cbd946dcc917da1e47889f6de1ce3d76d39dd7f95931d6834ca4f2f59a12e044e0b525b3defa238c77c6204300000000000000000000000000000000000000000000000000000000000000000306466fe5211732ffecadba72c39be7bc8ce5bbc5f7126b2c439b3a40000000ff8b8f39f5cae8dc180c93b5bf0c0030d8d49cee513e4aca2815dbb9be275880020300090398ab020000000000020200010c0200000008c3020000000000",
                            "status": 1,
                            "walletid": "13309",
                            "type": 1,
                            "asset": "SOL",
                            "chain": "SOL",
                            "timestamp": "2025-01-08T08:58:40.979Z",
                            "amount": 0.000181,
                            "destinationAddress": "GCT8eK7Jhi3FESmJ8bhnJt1RdkPjJrxLe3YvtGVNm8Qa",
                            "identifier": "2035bcea-7ac8-46ee-ffae-7baf603199c9",
                            "fromAddress": "GKv9nnMXCuoAD5taK5Gq6YWHcd2fmGQtYxfoQQfSYmXA",
                            "transactionSequenceId": 642544,
                            "sequenceId": "97f06168-b10d-0b37-cc89-95070712bb08",
                            "memo": null,
                            "id": 526259
                          },
                          {
                            "userid": 2428,
                            "raw": "010002041f67f433333e761e323ddc5e5456a56b734e24e9cc6672b895adccaa06290cdfe1ce3d76d39dd7f95931d6834ca4f2f59a12e044e0b525b3defa238c77c6204300000000000000000000000000000000000000000000000000000000000000000306466fe5211732ffecadba72c39be7bc8ce5bbc5f7126b2c439b3a40000000e4d01e18c867488bcff95e78d2a25303f84adc0d7736a5a2dcbf38c05af2ad84020300090398ab020000000000020200010c0200000008c3020000000000",
                            "status": 1,
                            "walletid": "13309",
                            "type": 1,
                            "asset": "SOL",
                            "chain": "SOL",
                            "timestamp": "2025-01-08T08:58:42.585Z",
                            "amount": 0.000181,
                            "destinationAddress": "GCT8eK7Jhi3FESmJ8bhnJt1RdkPjJrxLe3YvtGVNm8Qa",
                            "identifier": "07ac1ac0-44a8-bdd7-cd73-d2756aa9c370",
                            "fromAddress": "37baQe1Dxr6xjzmmLoq5WLhzM2f4ZRN2euqEvRTC5gna",
                            "transactionSequenceId": 642545,
                            "sequenceId": "acc657b1-984f-9533-4420-3b6282754038",
                            "memo": null,
                            "id": 526260
                          },
                          {
                            "userid": 2428,
                            "raw": "010002042ca0c568b1355ab04fcd1e916cd0a9349d51f830a703da8609c0397d8366f235e1ce3d76d39dd7f95931d6834ca4f2f59a12e044e0b525b3defa238c77c6204300000000000000000000000000000000000000000000000000000000000000000306466fe5211732ffecadba72c39be7bc8ce5bbc5f7126b2c439b3a40000000ff8b8f39f5cae8dc180c93b5bf0c0030d8d49cee513e4aca2815dbb9be275880020300090398ab020000000000020200010c0200000008c3020000000000",
                            "status": 1,
                            "walletid": "13309",
                            "type": 1,
                            "asset": "SOL",
                            "chain": "SOL",
                            "timestamp": "2025-01-08T08:58:44.034Z",
                            "amount": 0.000181,
                            "destinationAddress": "GCT8eK7Jhi3FESmJ8bhnJt1RdkPjJrxLe3YvtGVNm8Qa",
                            "identifier": "0f6e0ae9-f143-4537-a1f4-4c4bd4e4dc1c",
                            "fromAddress": "41D8HC6NjsJBz7mhTdkKVdFgxMY2bpaQaiU54C6iWCPv",
                            "transactionSequenceId": 642546,
                            "sequenceId": "814a77a3-e287-4c85-928b-5c1652311b43",
                            "memo": null,
                            "id": 526261
                          }
                        ]
                      }
                    }
                  ]
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json; charset=utf-8": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Consolidate-Transactions-Results-Address-is-Not-Whitelisted-Response1"
                    },
                    {
                      "example": {
                        "success": false,
                        "data": {},
                        "message": "address is not whitelisted",
                        "code": ""
                      }
                    }
                  ]
                },
                "example": {
                  "success": false,
                  "data": {},
                  "message": "address is not whitelisted",
                  "code": ""
                }
              }
            }
          }
        },
        "deprecated": false,
        "security": [
          {
            "basic": []
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "Get-Consolidation-Results-Success-Response": {
        "title": "Get-Consolidation-Results-Success-Response",
        "type": "object",
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "example": true,
            "description": "This indicates whether the list of addresses are successfully retrieved or not."
          },
          "data": {
            "type": "array",
            "description": "The list of addresses with details.",
            "items": {
              "type": "object",
              "properties": {
                "userid": {
                  "type": "integer",
                  "example": 2428,
                  "description": "The unique identifier of the user who called the API."
                },
                "raw": {
                  "type": "string",
                  "description": "The daw transaction data.",
                  "example": "01000204e3b7db6ab538a479dc25caab18a64157a1bc9478cbd946dcc917da1e47889f6de1ce3d76d39dd7f95931d6834ca4f2f59a12e044e0b525b3defa238c77c6204300000000000000000000000000000000000000000000000000000000000000000306466fe5211732ffecadba72c39be7bc8ce5bbc5f7126b2c439b3a40000000ff8b8f39f5cae8dc180c93b5bf0c0030d8d49cee513e4aca2815dbb9be275880020300090398ab020000000000020200010c0200000008c3020000000000"
                },
                "status": {
                  "type": "integer",
                  "example": 1,
                  "description": "The current transaction status."
                },
                "walletid": {
                  "type": "string",
                  "example": 13309,
                  "description": "The unique identifier of the wallet provided in the API request."
                },
                "type": {
                  "type": "integer",
                  "example": 1,
                  "description": "The type of transaction. Its value `1` represents normal, `2` represents NFT, and `3` represents staking."
                },
                "asset": {
                  "type": "string",
                  "example": "SOL",
                  "description": "The type of asset provided in the API request."
                },
                "chain": {
                  "type": "string",
                  "example": "SOL",
                  "description": "The blockchain protocol of the wallet."
                },
                "timestamp": {
                  "type": "string",
                  "format": "date-time",
                  "example": "2025-01-08T08:58:40.979Z",
                  "description": "The representation of time when the transaction is created."
                },
                "amount": {
                  "type": "number",
                  "format": "float",
                  "example": 0.000181,
                  "description": "The amount in the address that can be consolidated."
                },
                "destinationAddress": {
                  "type": "string",
                  "example": "GCT8eK7Jhi3FESmJ8bhnJt1RdkPjJrxLe3YvtGVNm8Qa",
                  "description": "The destination address of the wallet where the consolidation will take place.\""
                },
                "identifier": {
                  "type": "string",
                  "example": "2035bcea-7ac8-46ee-ffae-7baf603199c9",
                  "description": "The representation of the unique identifier of the transaction."
                },
                "fromAddress": {
                  "type": "string",
                  "example": "GKv9nnMXCuoAD5taK5Gq6YWHcd2fmGQtYxfoQQfSYmXA",
                  "description": "The address in the deposit wallet from which the amount will be participate in the consolidation process."
                },
                "transactionSequenceId": {
                  "type": "integer",
                  "example": 642544,
                  "description": "The representation of the unique identifier of the transaction."
                },
                "sequenceId": {
                  "type": "string",
                  "example": "97f06168-b10d-0b37-cc89-95070712bb08",
                  "description": "The representation of system-generated unique identifier of the transaction, used for tracking purposes."
                },
                "memo": {
                  "type": "string",
                  "nullable": true,
                  "example": null,
                  "description": "The memo tag associated with the address."
                },
                "id": {
                  "type": "integer",
                  "example": 526259,
                  "description": "The representation of the unique identifier of the transaction."
                }
              }
            }
          }
        }
      },
      "Consolidate-Transactions-Results-Address-is-Not-Whitelisted-Response1": {
        "title": "Consolidate-Transactions-Results-Address-is-Not-Whitelisted-Response1",
        "required": [
          "success",
          "data",
          "message",
          "code"
        ],
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object"
          },
          "message": {
            "type": "string"
          },
          "code": {
            "type": "string"
          }
        },
        "example": {
          "success": false,
          "data": {},
          "message": "address is not whitelisted",
          "code": ""
        }
      },
      "Get-Consolidation-Result-Addresses-Native-Coins-Request": {
        "title": "Get-Consolidation-Result-Addresses-Native-Coins-Request",
        "required": [
          "wallet",
          "transactions"
        ],
        "type": "object",
        "properties": {
          "wallet": {
            "type": "object",
            "properties": {
              "coin": {
                "type": "string",
                "description": "Enter the abbreviated form of the cryptocurrency associated with the wallet.",
                "example": "eth"
              },
              "walletId": {
                "type": "integer",
                "description": "Enter the unique identifier of the wallet.",
                "example": 1
              }
            },
            "required": [
              "coin",
              "walletId"
            ]
          },
          "transactions": {
            "type": "object",
            "properties": {
              "consolidateOptions": {
                "type": "object",
                "properties": {
                  "targetAddress": {
                    "type": "string",
                    "description": "Enter the destination address into which the assets will be consolidated.",
                    "example": "0x5dce8dc7ae6eeca7abb378406db5965c1a4684cd"
                  }
                },
                "required": [
                  "targetAddress"
                ]
              }
            },
            "required": [
              "consolidateOptions"
            ]
          }
        }
      },
      "Get-Consolidation-Result-Addresses-Tokens-Request": {
        "title": "Get-Consolidation-Result-Addresses-Tokens-Request",
        "required": [
          "wallet",
          "transactions"
        ],
        "type": "object",
        "properties": {
          "wallet": {
            "type": "object",
            "required": [
              "coin",
              "walletId",
              "allToken"
            ],
            "properties": {
              "coin": {
                "type": "string",
                "description": "Enter the abbreviated form of the cryptocurrency associated with the wallet.",
                "example": "eth"
              },
              "walletId": {
                "type": "integer",
                "description": "Enter the unique identifier of the wallet.",
                "example": 1
              },
              "allToken": {
                "type": "boolean",
                "description": "Set its value to true when performing operations with tokens (non-native assets).",
                "example": true
              },
              "tokenOptions": {
                "type": "object",
                "properties": {
                  "tokenName": {
                    "type": "string",
                    "description": "Enter the name of the token.",
                    "example": "dai"
                  },
                  "tokenAddress": {
                    "type": "string",
                    "description": "Provide the blockchain contract address for the specified token.",
                    "example": "0xdc31Ee1784292379Fbb2964b3B9C4124D8F89C60"
                  }
                },
                "required": [
                  "tokenName",
                  "tokenAddress"
                ]
              }
            }
          },
          "transactions": {
            "type": "object",
            "properties": {
              "consolidateOptions": {
                "type": "object",
                "properties": {
                  "targetAddress": {
                    "type": "string",
                    "description": "Enter the destination address into which the assets will be consolidated.",
                    "example": "0x5dce8dc7ae6eeca7abb378406db5965c1a4684cd"
                  }
                },
                "required": [
                  "targetAddress"
                ]
              }
            },
            "required": [
              "consolidateOptions"
            ]
          }
        }
      }
    },
    "securitySchemes": {
      "basic": {
        "type": "http",
        "scheme": "basic"
      }
    }
  },
  "security": []
}
```