# Cohorts & funding relationships.

> Source: https://implyra.com/docs/cohorts-funding
> Implyra API docs · API reference · Cohorts & funding

Explore groups of traders, their positioning and observed wallet funding sources.

Transport: GET

## Discover available cohorts

`GET /cohorts`

Start with the cohort index to discover available tiers. A cohort groups wallets by pnl or size. Use the returned tier identifiers rather than hard-coding guessed names.

| Name | Type | Description |
| --- | --- | --- |
| `GET /cohorts/:type/:tier` | Summary | Group counts, portfolio and realized P&L totals, and YES/NO notional positioning. |
| `GET /cohorts/:type/:tier/wallets` | Members | Wallets in the cohort, with limit/offset pagination and sortBy/sortOrder. |
| `GET /cohorts/:type/:tier/markets` | Markets | Markets associated with the cohort, with limit/offset pagination. |

## Compare group positioning over time

`GET /cohorts/:type/:tier/positioning`

| Name | Type | Description |
| --- | --- | --- |
| `type / tier` | path | Type is pnl or size. Tier comes from the cohort index. |
| `window` | 24h \| 7d \| 30d | Historical window; defaults to 7d. |
| `data[]` | time series | Each point contains timestamp, yesPct, totalNotionalUsd and traderCount. |

> **Show the underlying group.** A group’s aggregate YES exposure is not a probability forecast. Keep the cohort definition and sample count visible.

## Inspect a wallet’s funding sources

`GET /funding/wallet/:address`

| Name | Type | Description |
| --- | --- | --- |
| `funding_sources[]` | records | Source addresses, first/last funding timestamps, deposit/withdrawal counts and totals. |
| `total_deposited / total_withdrawn / net_flow` | decimal strings | Amounts are serialized as strings. Use an appropriate decimal representation when aggregating them. |
| `unique_sources` | number | The reported count of funding sources. |

```sh
: "${WALLET_ADDRESS:?Set the wallet to inspect}"

curl --fail-with-body \
  "${IMPLYRA_API_URL%/}/funding/wallet/$WALLET_ADDRESS?limit=20&offset=0"
```

## Follow an observed relationship

| Name | Type | Description |
| --- | --- | --- |
| `GET /funding/source/:address` | Source | Inspect funding activity from a source address. |
| `GET /funding/shared-source?source=…` | Shared source | Find wallets funded by the same source. Supports min_amount and a limit up to 100. |
| `GET /funding/label/:address` | Label | Fetch an available source label. |

> **A link is evidence, not identity.** Common exchanges and other services can fund unrelated wallets. A shared source does not establish common ownership, coordinated trading or privileged information.
