Get Address History

This content applies to WaaS 1.0 only. We highly recommend that you upgrade to WaaS 2.0.

This endpoint returns a list of addresses associated with a custody wallet for a given coin, with pagination support. The response is a JSON array of objects, each containing a ‘coin’ field and an ‘address’ field.

GET /v1/custody/address_history/

Python

request(
  "GET",
  "/v1/custody/address_history/",
  {
    "coin": "ETH",
    "page_index": 0,
    "page_length": 20,
  },
  api_key, api_secret, host
)

coboFetch('GET', '/v1/custody/address_history/',
        {
          "coin": "ETH",
          "page_index": 0,
          "page_length": 20,
        },
        api_key, api_secret, host
    ).then(res => {
        res.json().then((data)=>{
            console.log(JSON.stringify(data, null, 4));
        })
    }).catch(err => {
        console.log(err)
    });

Request("GET", "/v1/custody/address_history/", map[string]string{
    "coin": "ETH",
    "page_index": 0,
    "page_length": 20,
})

Response

{
  "success": true,
  "result": [
    {
      "coin": "ETH",
      "address": "0x544094588811118b7701cf4a9dea056e775b4b4e"
    },
    {
      "coin": "ETH",
      "address": "0x644094588811118b7701cf4a9dea056e775b4b4e"
    },
    {
      "coin": "ETH",
      "address": "0x574094588811118b7701cf4a9dea056e775b4b4e"
    }
  ]
}

Request

coin · String · required

The coin symbol.

page_index · Int

The page index, starting from 0.

page_length · Int

The number of items per page.

sort_flag · Int

The sort flag, 0 for ascending and 1 for descending.

Response

success · bool

request successful or failed

result · object[]

Show object

coin · String · required

The coin symbol.

address · String · required

The address associated with the custody wallet.

Python

request(
  "GET",
  "/v1/custody/address_history/",
  {
    "coin": "ETH",
    "page_index": 0,
    "page_length": 20,
  },
  api_key, api_secret, host
)

coboFetch('GET', '/v1/custody/address_history/',
        {
          "coin": "ETH",
          "page_index": 0,
          "page_length": 20,
        },
        api_key, api_secret, host
    ).then(res => {
        res.json().then((data)=>{
            console.log(JSON.stringify(data, null, 4));
        })
    }).catch(err => {
        console.log(err)
    });

Request("GET", "/v1/custody/address_history/", map[string]string{
    "coin": "ETH",
    "page_index": 0,
    "page_length": 20,
})

Response

{
  "success": true,
  "result": [
    {
      "coin": "ETH",
      "address": "0x544094588811118b7701cf4a9dea056e775b4b4e"
    },
    {
      "coin": "ETH",
      "address": "0x644094588811118b7701cf4a9dea056e775b4b4e"
    },
    {
      "coin": "ETH",
      "address": "0x574094588811118b7701cf4a9dea056e775b4b4e"
    }
  ]
}