# Get Proxy Calls

Returns indexed proxy calls with the signer, real account, call arguments and extrinsic details.

_Source: https://beta.taostats.io/docs/api-reference/chain/get-proxy-call_

_Last reviewed: 2026-09-18_

```http
GET https://api.taostats.io/api/proxy_call/v1
```

Requires an API key in the `Authorization` header.

Returns indexed proxy calls with the signer, real account, call arguments and extrinsic details. Records include the network, block number and timestamp.

## Try it

Try this request in the browser on the HTML version of this page, or use the code samples below.

### Examples

List proxy calls executed on behalf of a wallet

```text
https://api.taostats.io/api/proxy_call/v1?real_address=5GH2aUTMRUh1RprCgH4x3tRyCaKeUi5BfmYCfs1NARA8R54n&order=block_number_desc&limit=50
```

### Code samples

**cURL**

```bash
curl -H "Authorization: <YOUR_API_KEY>" \
  "https://api.taostats.io/api/proxy_call/v1?real_address=5GH2aUTMRUh1RprCgH4x3tRyCaKeUi5BfmYCfs1NARA8R54n&limit=50&order=block_number_desc"
```

**JavaScript**

```js
const response = await fetch('https://api.taostats.io/api/proxy_call/v1?real_address=5GH2aUTMRUh1RprCgH4x3tRyCaKeUi5BfmYCfs1NARA8R54n&limit=50&order=block_number_desc', {
  headers: {
    Authorization: '<YOUR_API_KEY>',
  },
});
const data = await response.json();
```

**Python**

```python
import requests

response = requests.get(
    "https://api.taostats.io/api/proxy_call/v1?real_address=5GH2aUTMRUh1RprCgH4x3tRyCaKeUi5BfmYCfs1NARA8R54n&limit=50&order=block_number_desc",
    headers={"Authorization": "<YOUR_API_KEY>"},
)
data = response.json()
```

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | query | `string` |  |  |
| `signer_address` | query | `string` |  | SS58 or hex format |
| `real_address` | query | `string` |  | SS58 or hex format |
| `network` | query | `string` |  |  |
| `block_number` | query | `integer (int32)` |  | The exact block number |
| `block_start` | query | `integer (int32)` |  | Start of block range (inclusive) |
| `block_end` | query | `integer (int32)` |  | End of block range (inclusive) |
| `timestamp_start` | query | `integer (int64)` |  | Start of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive) |
| `timestamp_end` | query | `integer (int64)` |  | End of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive) |
| `extrinsic_hash` | query | `string` |  | Hash value of the extrinsic |
| `extrinsic_id` | query | `string` |  | ID of the extrinsic |
| `page` | query | `integer (int32)` |  |  |
| `limit` | query | `integer (int32)` |  |  |
| `order` | query | `string` |  | One of `block_number_asc`, `block_number_desc`, `timestamp_asc`, `timestamp_desc`. |

## Responses

### `200` — Proxy calls retrieved successfully

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `data` | `array` | Yes |  |
| `data[].args` | `object` | Yes |  |
| `data[].block_number` | `integer (int32)` | Yes |  |
| `data[].extrinsic_hash` | `string` | Yes |  |
| `data[].extrinsic_id` | `string` | Yes |  |
| `data[].id` | `string` | Yes |  |
| `data[].network` | `string` | Yes |  |
| `data[].real_address` | `object` | Yes |  |
| `data[].real_address.hex` | `string` | Yes | The hex format of the hot key |
| `data[].real_address.ss58` | `string` | Yes | The SS58 format of the hot key |
| `data[].signer_address` | `object` | Yes |  |
| `data[].signer_address.hex` | `string` | Yes | The hex format of the hot key |
| `data[].signer_address.ss58` | `string` | Yes | The SS58 format of the hot key |
| `data[].timestamp` | `string (date-time)` | Yes |  |
| `pagination` | `object` | Yes |  |
| `pagination.current_page` | `integer (int32)` | Yes |  |
| `pagination.next_page` | `integer (int32), nullable` |  |  |
| `pagination.per_page` | `integer (int32)` | Yes |  |
| `pagination.prev_page` | `integer (int32), nullable` |  |  |
| `pagination.total_items` | `integer (int32)` | Yes |  |
| `pagination.total_pages` | `integer (int32)` | Yes |  |

**Example response**

```json
{
  "data": [
    {
      "args": {
        "__kind": "add_stake",
        "amountStaked": "2439150440",
        "hotkey": "0x2c36c8b88903c8507aa3a9a6dcfc016caf5cfd3d8bf755b97e63f8f8b7c56836",
        "netuid": 13
      },
      "block_number": 5373739,
      "extrinsic_hash": "0x502304229fe04a858411c9ba98130240d92021911cb44f1a3f880e30c9f564ad",
      "extrinsic_id": "5373739-0025",
      "id": "finney-5373739-0025",
      "network": "finney",
      "real_address": {
        "hex": "0x229b1b5ca004dee89d57300d194913635011f5dd90f440806f0f85171e5f8876",
        "ss58": "5Cr5ZXWF6DHhDzkgmJ9pqyEcasDfNrMX4QdZAet5QZHefMGU"
      },
      "signer_address": {
        "hex": "0x50bf0fac3fd0ce371e666799756d33ccec3c6edaeab8dffe371936cd23ba9d69",
        "ss58": "5DtaSm9cgtvTzEH9kSAmXVajtfKLGAhqDtUeTzSvdn7QiMoR"
      },
      "timestamp": "2025-04-17T21:01:24.001Z"
    },
    {
      "args": {
        "__kind": "unstake_all",
        "hotkey": "0x2c36c8b88903c8507aa3a9a6dcfc016caf5cfd3d8bf755b97e63f8f8b7c56836"
      },
      "block_number": 5373738,
      "extrinsic_hash": "0xb5ca9d0bacfc4980caaaab4c49be2f7748c92d1e3551646691aebdc54950839b",
      "extrinsic_id": "5373738-0038",
      "id": "finney-5373738-0038",
      "network": "finney",
      "real_address": {
        "hex": "0x0401ab945a33931436911328500ba51c95ede0bf6137bee326232d77b80a1560",
        "ss58": "5C9xYZAkGGG3dpnkpLDCHqZjD1FvsX8oe9HnHXXr7jaCCvym"
      },
      "signer_address": {
        "hex": "0x8c476f597851cba678abe6fd332cc926e1f31ac5a0ded0d7aeaf72cf638cfc34",
        "ss58": "5FEdnHfu4G4D5G8FDvpp4c24wNWQEeuSAXpk96fUniBaMNA9"
      },
      "timestamp": "2025-04-17T21:01:12Z"
    }
  ],
  "pagination": {
    "current_page": 1,
    "next_page": 2,
    "per_page": 50,
    "prev_page": null,
    "total_items": 25203,
    "total_pages": 505
  }
}
```

**Response details**

```text
  {
      "id": "finney-5453581-0001",
      "network": "finney",
      "block_number": 5453581,
      "timestamp": "2025-04-28T23:09:48Z",
      "signer_address": {
        "ss58": "5EnnowUt23kSBGd9R5KK2BSqCyRY1thmAkMqy7bZpspymaQr",
        "hex": "0x7891727004cda5df22d8ee804b6b09a39c1ced550e7d589ef00d720b692b094d"
      },
      "real_address": {
        "ss58": "5E52QXBk3CaqCX2dPbxFxn1x29XyxLPP3PP8evcuARSenaXq",
        "hex": "0x58b6e8b53c798ad29c90721177e6a5732f3286345d7748782c885bc2c07a1b5f"
      },
      "args": {
        "__kind": "add_stake_limit",
        "allowPartial": false,
        "amountStaked": "699902633", as rao
        "hotkey": "0x84d83d08ca89f8e60424ffa286f165c16dd8752e4faa4d8977221e6720678d28",
        "limitPrice": "9317053963",
        "netuid": 99
      },
      "extrinsic_id": "5453581-0001",as rao
      "extrinsic_hash": "0x8ff1f3aefd566007a04d20cba51b5b4327bc11cf340ce7f7a74c4368132d5fbb"
    },
```

### Other responses

| Status | Meaning |
| --- | --- |
| `400` | Bad request |
| `404` | Proxy calls not found |
| `500` | Internal server error |

Every request needs an `Authorization` header holding your API key — see [Getting started with the Taostats API](https://beta.taostats.io/docs/start-here/getting-started-with-taostats-api).