# Wallets & devs

> Wallet profiles with holdings and PnL, wallet trade history, funding connections and token developer profiles on Robinhood Chain.

Source: https://crius.sh/docs/reference/wallets/

Wallet-level data: what a wallet holds and earned, every trade it made, who funded it, and for token creators, every token they launched and how those did.

| Endpoint | Method | Plan | Credits |
|---|---|---|---|
| [Wallet profile](#wallet-profile) | `GET /v1/{chain}/wallet/{address}` | Starter | 5 |
| [Wallet trades](#wallet-trades) | `GET /v1/{chain}/wallet/{address}/trades` | Starter | 5 |
| [Wallet connections](#wallet-connections) | `GET /v1/{chain}/wallet/{address}/connections` | Starter | 10 |
| [Developer profile](#developer-profile) | `GET /v1/{chain}/dev/{address}` | Free | 5 |

## Wallet profile

**GET** `/v1/{chain}/wallet/{address}`

**Plan:** Starter and above · **Cost:** 5 credits per call

Holdings with USD value, realized and unrealized PnL over a window (`1d`, `7d`, `30d`, `all`), win rate and wallet tags. `min_value_usd` hides dust.

### Parameters

| Name | In | Type | Default | Description |
|---|---|---|---|---|
| `chain` | path, required | string |  | Chain slug (`robinhood`) or chain id (`4663`). |
| `address` | path, required | string |  | Contract or wallet address, any case (`0x…`, 20 bytes). |
| `window` | query | string | `30d` | Stats window. One of `1d`, `7d`, `30d`, `all`. |
| `min_value_usd` | query | number |  | Hide holdings worth less than this many USD. |

### Request

**cURL**

```bash
curl "https://api.crius.sh/v1/robinhood/wallet/0x3ac82d45ff9e4963cefbc3f74dbe293f34c927ca?window=30d" \
  -H "x-api-key: $CRIUS_API_KEY"
```

**JavaScript**

```js
const res = await fetch("https://api.crius.sh/v1/robinhood/wallet/0x3ac82d45ff9e4963cefbc3f74dbe293f34c927ca?window=30d", {
  headers: { "x-api-key": process.env.CRIUS_API_KEY },
});
const { data, meta } = await res.json();
```

**Python**

```python
import os, requests

r = requests.get(
    "https://api.crius.sh/v1/robinhood/wallet/0x3ac82d45ff9e4963cefbc3f74dbe293f34c927ca?window=30d",
    headers={"x-api-key": os.environ["CRIUS_API_KEY"]},
)
body = r.json()
print(body["data"])
```

## Wallet trades

**GET** `/v1/{chain}/wallet/{address}/trades`

**Plan:** Starter and above · **Cost:** 5 credits per call

Every trade the wallet made across all tokens, newest first, in the same shape as the trade tape plus the token. Filter by `token`, `side`, `min_usd` and time.

### Parameters

| Name | In | Type | Default | Description |
|---|---|---|---|---|
| `chain` | path, required | string |  | Chain slug (`robinhood`) or chain id (`4663`). |
| `address` | path, required | string |  | Contract or wallet address, any case (`0x…`, 20 bytes). |
| `token` | query | string |  | Only trades of this token. |
| `side` | query | string |  | `buy` or `sell`. |
| `min_usd` | query | number |  | Only items worth at least this many USD. |
| `from_ts` | query | integer |  | Start of the time range, unix milliseconds (inclusive). |
| `to_ts` | query | integer |  | End of the time range, unix milliseconds (inclusive). |
| `limit` | query | integer | `50` | Maximum number of items to return. |
| `cursor` | query | string |  | Pagination cursor from the previous response's `meta.next_cursor`. |

### Request

**cURL**

```bash
curl "https://api.crius.sh/v1/robinhood/wallet/0x3ac82d45ff9e4963cefbc3f74dbe293f34c927ca/trades?limit=20" \
  -H "x-api-key: $CRIUS_API_KEY"
```

**JavaScript**

```js
const res = await fetch("https://api.crius.sh/v1/robinhood/wallet/0x3ac82d45ff9e4963cefbc3f74dbe293f34c927ca/trades?limit=20", {
  headers: { "x-api-key": process.env.CRIUS_API_KEY },
});
const { data, meta } = await res.json();
```

**Python**

```python
import os, requests

r = requests.get(
    "https://api.crius.sh/v1/robinhood/wallet/0x3ac82d45ff9e4963cefbc3f74dbe293f34c927ca/trades?limit=20",
    headers={"x-api-key": os.environ["CRIUS_API_KEY"]},
)
body = r.json()
print(body["data"])
```

## Wallet connections

**GET** `/v1/{chain}/wallet/{address}/connections`

**Plan:** Starter and above · **Cost:** 10 credits per call

Wallets connected to this one through funding and transfers: who funded it, who it funded, and wallets sharing a funder.

### Parameters

| Name | In | Type | Default | Description |
|---|---|---|---|---|
| `chain` | path, required | string |  | Chain slug (`robinhood`) or chain id (`4663`). |
| `address` | path, required | string |  | Contract or wallet address, any case (`0x…`, 20 bytes). |
| `limit` | query | integer | `25` | Maximum number of items to return. |

### Request

**cURL**

```bash
curl "https://api.crius.sh/v1/robinhood/wallet/0x3ac82d45ff9e4963cefbc3f74dbe293f34c927ca/connections" \
  -H "x-api-key: $CRIUS_API_KEY"
```

**JavaScript**

```js
const res = await fetch("https://api.crius.sh/v1/robinhood/wallet/0x3ac82d45ff9e4963cefbc3f74dbe293f34c927ca/connections", {
  headers: { "x-api-key": process.env.CRIUS_API_KEY },
});
const { data, meta } = await res.json();
```

**Python**

```python
import os, requests

r = requests.get(
    "https://api.crius.sh/v1/robinhood/wallet/0x3ac82d45ff9e4963cefbc3f74dbe293f34c927ca/connections",
    headers={"x-api-key": os.environ["CRIUS_API_KEY"]},
)
body = r.json()
print(body["data"])
```

## Developer profile

**GET** `/v1/{chain}/dev/{address}`

**Plan:** Free and above · **Cost:** 5 credits per call

A token creator's track record: every token they deployed or launched, with peak market cap, current state and outcomes.

> Tokens created (launchpad + direct deployments), outcomes, funding.

### Parameters

| Name | In | Type | Default | Description |
|---|---|---|---|---|
| `chain` | path, required | string |  | Chain slug (`robinhood`) or chain id (`4663`). |
| `address` | path, required | string |  | Contract or wallet address, any case (`0x…`, 20 bytes). |
| `sort` | query | string | `created` | Sort order. One of `created`, `ath`, `market_cap`. |
| `limit` | query | integer | `50` | Maximum number of items to return. |

### Request

**cURL**

```bash
curl "https://api.crius.sh/v1/robinhood/dev/0x3ac82d45ff9e4963cefbc3f74dbe293f34c927ca?sort=created" \
  -H "x-api-key: $CRIUS_API_KEY"
```

**JavaScript**

```js
const res = await fetch("https://api.crius.sh/v1/robinhood/dev/0x3ac82d45ff9e4963cefbc3f74dbe293f34c927ca?sort=created", {
  headers: { "x-api-key": process.env.CRIUS_API_KEY },
});
const { data, meta } = await res.json();
```

**Python**

```python
import os, requests

r = requests.get(
    "https://api.crius.sh/v1/robinhood/dev/0x3ac82d45ff9e4963cefbc3f74dbe293f34c927ca?sort=created",
    headers={"x-api-key": os.environ["CRIUS_API_KEY"]},
)
body = r.json()
print(body["data"])
```