> For the complete documentation index, see [llms.txt](https://docs.stablix.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stablix.xyz/01-introduction.md).

# 01 introduction

Welcome to the Stablix API documentation. Stablix is a non-custodial crypto payment platform that enables businesses to accept USDC and USDT payments on Solana and Base blockchains.

## What is Stablix?

Stablix provides a secure, escrow-based payment infrastructure for online businesses. When a customer pays, funds are held in a smart contract escrow until the merchant releases them or the buffer period expires.

**Key Features:**

* Accept USDC/USDT on Solana and Base
* Non-custodial escrow protection
* Recurring subscriptions with token approvals
* Built-in dispute resolution
* Real-time webhooks
* Tiered volume limits with KYC

## How It Works

{% stepper %}
{% step %}

### Merchant creates invoice

Stablix generates a deposit address for the invoice.
{% endstep %}

{% step %}

### Buyer sends payment

Funds go to the escrow smart contract.
{% endstep %}

{% step %}

### Funds release or dispute

* Buffer period passes → Funds auto-release to merchant
* OR Dispute opened → Admin resolves, funds distributed accordingly
  {% endstep %}
  {% endstepper %}

## Base URL

```
Production: https://api.stablix.xyz/api/v1
```

## Supported Chains & Tokens

| Chain  | Tokens     | Settlement Time |
| ------ | ---------- | --------------- |
| Solana | USDC, USDT | \~400ms         |
| Base   | USDC, USDT | \~2 seconds     |

## Volume Limits

| Tier     | Monthly Volume | Single Transaction | Requirements          |
| -------- | -------------- | ------------------ | --------------------- |
| Starter  | $5,000         | $1,000             | Email verification    |
| Verified | $50,000        | $10,000            | KYC approved          |
| Business | Unlimited      | $100,000           | Business verification |

## Fees

| Fee Type                  | Amount          |
| ------------------------- | --------------- |
| Standard payment          | 0.5%            |
| Dispute resolution        | +1.0%           |
| Extended escrow (>7 days) | +0.15% per week |

## Quick Start

{% stepper %}
{% step %}

* Create an account: /authentication/signup
  {% endstep %}

{% step %}

* Get your API keys: /authentication/api-keys
  {% endstep %}

{% step %}

* Create your first invoice: /invoices/create
  {% endstep %}

{% step %}

* Set up webhooks: /webhooks/setup
  {% endstep %}
  {% endstepper %}

## Need Help?

* Email: <support@stablix.xyz>
* Discord: discord.gg/stablix
* GitHub: github.com/stablix