# GET /intelligence/addresses/updates

**Operation ID:** `GetAddressUpdates`

Get address intelligence updates

Returns a feed of address label, entity, and tag changes with cursor-based pagination.

## Parameters

| Name | In | Type | Required | Description |
|------|-----|------|----------|-------------|
| `since` | query | string | No | Returns changes since this time. Required unless both 'from' and 'to' are provided; mutually exclusive with 'from'/'to'. Example: `"2025-01-01T00:00:00Z"` |
| `from` | query | string | No | Start of time window (use with 'to', max 7-day window). Provide together with 'to' as an alternative to 'since'; mutually exclusive with 'since'. Example: `"2025-01-01T00:00:00Z"` |
| `to` | query | string | No | End of time window (use with 'from', max 7-day window). Provide together with 'from' as an alternative to 'since'; mutually exclusive with 'since'. Example: `"2025-01-07T00:00:00Z"` |
| `status` | query | string | No | Filter by change status. Example: `"new"` |
| `address` | query | array | No | Blockchain addresses to filter by. Max 100. Example: `["0x28C6c06298d514Db089934071355E5743bf21d60"]` |
| `chain` | query | array | No | Blockchain networks to filter by. Example: `["ethereum","bsc"]` |
| `entityId` | query | array | No | Entity IDs to filter by. Max 100. Example: `["binance","coinbase"]` |
| `entityType` | query | array | No | Entity types to filter by. Max 100. Example: `["cex","dex","fund"]` |
| `label` | query | string | No | Filter by address label. Example: `"Cold Wallet"` |
| `service` | query | boolean | No | Filter by service addresses. Example: `true` |
| `depositExchangeId` | query | array | No | Deposit exchange entity IDs to filter by. Max 100. Example: `["binance","coinbase"]` |
| `tagId` | query | array | No | Tag IDs to filter by. Max 100. Example: `["gnosis-safe-signer","contract-deployer"]` |
| `tagParams` | query | string | No | Filter by tag parameters (JSON string matching tag-specific params). Example: `"Binance"` |
| `orderBy` | query | string | No | Sort order: 'time' (asc), 'balance', 'volume', or 'transfers' (desc). Default 'time'. Example: `"time"` |
| `limit` | query | integer | No | Maximum results to return (1-1000, default 100). Example: `100` |
| `includeTags` | query | boolean | No | Whether to include address tags in the response. Defaults to true. Example: `true` |
| `includeEntityPredictions` | query | boolean | No | Whether to include entity predictions in the response. Defaults to true. Example: `true` |
| `includeClusters` | query | boolean | No | Whether to include cluster data in the response. Defaults to true. Example: `true` |
| `pageToken` | query | string | No | Cursor token for pagination (from previous response). Example: `"eyJkIjoiMjAyNS0wMS0wMVQwMDowMDowMFoiLCJxIjowfQ=="` |

## Responses

- **200**: OK
  **Schema** (object):
    - **hasMore** (boolean (required)): Whether more results are available beyond this page. Example: `true`
    - **items**: (array)
      - **(items)**: ([AddressUpdate](https://arkm.com/llms/schemas/AddressUpdate.md))
    - **latest_diff_ts** (string (required)): Most recent change timestamp in this response. Use as 'since' parameter for incremental sync. Null if no items returned. Example: `"2025-04-09T00:00:00Z"`
    - **pageToken** (string): Opaque cursor for fetching the next page. Empty when no more pages. Example: `"eyJkIjoiMjAyNS0wMi0wMlQwMDowMDowMFoiLCJxIjoyfQ=="`

**Example:**
```json
{
  "hasMore": true,
  "items": [
    {
      "address": "0x000000000000012DeF132E61759048bE5b5C6033",
      "chain": "arbitrum_one",
      "deposit_exchange_id": null,
      "diff_seq": 1,
      "diff_ts": "2025-01-01T00:00:00Z",
      "entity_id": null,
      "entity_name": null,
      "entity_type": null,
      "label": "Cortex (CX)",
      "populated_tags": [
        {
          "chain": "arbitrum_one",
          "disablePage": true,
          "excludeEntities": true,
          "id": "token-label",
          "label": "%s",
          "rank": 380,
          "tagParams": "Cortex (CX)"
        },
        {
          "chain": "arbitrum_one",
          "disablePage": true,
          "excludeEntities": true,
          "id": "token-standard",
          "label": "%s Token",
          "rank": 300,
          "tagParams": "ERC20"
        }
      ],
      "service": false,
      "status": "new"
    },
    {
      "address": "0x000BAE686D6f10C9715593bD9d06cc03E7529c18",
      "chain": "arbitrum_one",
      "deposit_exchange_id": null,
      "diff_seq": 39,
      "diff_ts": "2025-01-01T00:00:00Z",
      "entity_id": "uniswap",
      "entity_name": "Uniswap",
      "entity_type": "dex",
      "label": "V3 Pool",
      "populated_tags": [
        {
          "chain": "arbitrum_one",
          "disablePage": false,
          "excludeEntities": false,
          "id": "dex",
          "label": "Decentralized Exchange",
          "rank": 50
        }
      ],
      "service": false,
      "status": "new"
    }
  ],
  "latest_diff_ts": "2025-01-01T00:00:00Z",
  "pageToken": "eyJkIjoiMjAyNS0wMS0wMVQwMDowMDowMFoiLCJxIjoxMDB9"
}
```
- **400**: Bad Request
- **500**: Internal Server Error

## Example

```bash
curl -X GET "https://api.arkm.com/intelligence/addresses/updates?since=2025-01-01T00:00:00Z&from=2025-01-01T00:00:00Z&to=2025-01-07T00:00:00Z&status=new&address=0x28C6c06298d514Db089934071355E5743bf21d60&chain=ethereum,bsc&entityId=binance,coinbase&entityType=cex,dex,fund&label=Cold Wallet&service=true&depositExchangeId=binance,coinbase&tagId=gnosis-safe-signer,contract-deployer&tagParams=Binance&orderBy=time&limit=100&includeTags=true&includeEntityPredictions=true&includeClusters=true&pageToken=eyJkIjoiMjAyNS0wMS0wMVQwMDowMDowMFoiLCJxIjowfQ==" \
  -H "API-Key: YOUR_API_KEY"
```