# Data Fetching & Pool Introspection

Initialisation always works the same way -- pick a chain and a provider, and create the ionic object

```typescript
// Initialisation always works the same way -- 
// pick a chain and a provider, and create the ionic object

const sdk = new IonicSdk(provider, chainId);
```

### `fetchPoolData`

**Arguments:**

* `poolId: string`
* `address?: string`

**Returns:**

* `Promise<IonicPoolData>`

The `poolId` is the canonical pool index, retrievable via the UI. E.g. <https://app.ionic.money/56/pool/1> -> `poolId = 1`

The `address` is the address of a pool user, e.g. someone that has provided liquidity, or borrowed assets. If passed, the function will returned detailed information about the user's balances.

```typescript
const poolData = await sdk.fetchPoolData("1", "0x111...")

poolData.assets.map((a) => console.log(a.underlyingSymbol));

>>> "2brl", "WBNB", "ETH", "BUSD"
```

This returns a `Promise` of [`IonicPoolData`](/developers/ionic-sdk/api-reference-typing-and-interfaces.md#ionicpooldata). Check out the type definition for more information about the data contained in it.

### `fetchPools`

**Arguments:**

* `filter: string | null`
* `options: { from: string })`

**Returns:**

* `Promise<IonicPoolData[]>`

Returns an array of ionic pools, given a specific filter. Filters can be:

```typescript
"created-pools" | "verified-pools" | "unverified-pools"
```

Passing the `{ from: address }` will return the detailed balances of the address provided

### `fetchPoolsManual`

* `verification: boolean`
* `options: { from: string }`

**Returns:**

* `Promise<(IonicPoolData | null)[] | undefined>`

Slightly optimised data fetching function for expensive calculations that handles failures gracefully in case of using less efficient RPC endpoints


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ionic.money/developers/ionic-sdk/data-fetching-and-pool-introspection.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.