> ## Documentation Index
> Fetch the complete documentation index at: https://docs.monei.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting Started

> The official Monei Python SDK install, configure, and use every service in one place

<Note>
  The Monei Python SDK is written in Python and ships with full type hints. It works in any Python ≥ 3.8 environment and supports both sync and async operations.
</Note>

## Installation

<CodeGroup>
  ```bash pip theme={null}
  pip install monei-sdk
  ```

  ```bash poetry theme={null}
  poetry add monei-sdk
  ```

  ```bash pipenv theme={null}
  pipenv install monei-sdk
  ```
</CodeGroup>

***

## Initialization

```python theme={null}
from monei import MoneiClient

monei = MoneiClient(
    api_key=os.environ.get("MONEI_API_KEY")
)
```

### Configuration Options

| Option     | Type  | Required | Description                                               |
| ---------- | ----- | -------- | --------------------------------------------------------- |
| `api_key`  | `str` | Yes      | Your API key from the [Monei dashboard](https://monei.cc) |
| `base_url` | `str` | No       | Override the base URL (useful for sandbox)                |
| `timeout`  | `int` | No       | Request timeout in seconds (default: 30)                  |

***

## SDK Services Overview

| Namespace                | Service Class            | What it does                            |
| ------------------------ | ------------------------ | --------------------------------------- |
| `monei.user`             | `UserService`            | Fetch and update the authenticated user |
| `monei.wallet_account`   | `WalletAccountService`   | Wallet info and virtual accounts        |
| `monei.deposit`          | `DepositService`         | Naira wallet deposits                   |
| `monei.payout`           | `PayoutService`          | Bank & peer transfers                   |
| `monei.wallet_utility`   | `WalletUtilityService`   | Bank lookup & account verification      |
| `monei.payment_method`   | `PaymentMethodService`   | Saved payment methods                   |
| `monei.evm`              | `EvmService`             | EVM blockchain operations               |
| `monei.solana`           | `SolanaService`          | Solana blockchain operations            |
| `monei.exchange`         | `ExchangeService`        | Token swaps (EVM & Solana)              |
| `monei.bills`            | `BillService`            | Airtime, data, electricity, cable TV    |
| `monei.transactions`     | `TransactionService`     | Transaction history & lookup            |
| `monei.bill_discovery`   | `BillDiscoveryService`   | Fetch available biller items            |
| `monei.offramp_payouts`  | `OfframpPayoutService`   | Offramp bank lookup & verification      |
| `monei.bill_pay`         | `BillPayService`         | Payment for bills                       |
| `monei.offramp_ledger`   | `OfframpLedgerService`   | Offramp transaction history & lookup    |
| `monei.bill_records`     | `BillRecordsService`     | Bills history & lookup                  |
| `monei.offramp_exchange` | `OfframpExchangeService` | Swap crypto to fiat                     |
| `monei.bill_validation`  | `BillValidationService`  | Validate bills                          |
| `monei.business`         | `BusinessService`        | Business customer operations            |

***