Getting Started

This guide takes you from zero to your first successful API operation.

Step 1: Generate your API key

In the Minteo Dashboard (or Sandbox Dashboard for testing):

1. Navigate to Developers > API Keys
2. Click Create API Key
3. Select the scopes you need:

Scope	Permissions
wallets:all	List wallets
wallets:details	Get wallet by ID
wallets:create	Create wallets (sandbox only)
payins:create	Create payins
payins:all	List payins
payins:details	Get payin by ID
payouts:create	Create payouts
payouts:all	List payouts
payouts:details	Get payout by ID
orders:create	Create orders
orders:all	List orders
orders:details	Get order by ID
bridge:create	Create bridges
bridge:all	List bridges
bridge:details	Get bridge by ID
bank_accounts:all	List bank accounts
bank_accounts:details	Get bank account by ID

Save your key

You won't be able to see the API key again after creation. Copy and store it securely.

Step 2: Verify your connection

Test that your API key works by listing your wallets:

Production

GET/v1/wallets

curl https://api.minteo.finance/v1/wallets \
-H "Authorization: Bearer YOUR_API_KEY"

Sandbox

GET/v1/wallets

curl https://api.sandbox.minteo.finance/v1/wallets \
-H "Authorization: Bearer YOUR_API_KEY"

You should get a 200 response with your wallets:

Production

RESPONSE

{
  "output": [
    {
      "id": "ffdda2d3-4278-45ac-b244-8499dc1a8906",
      "wallet_name": "Main Wallet",
      "chain": "POLYGON",
      "currency_id": "COPM",
      "address": "0xacf8D012Fb6245aFD475E3ecae90cFAfC2c601A3"
    }
  ],
  "code": "OK"
}

Sandbox

RESPONSE

{
  "output": [
    {
      "id": "ffdda2d3-4278-45ac-b244-8499dc1a8906",
      "wallet_name": "Main Wallet",
      "chain": "POLYGON",
      "currency_id": "testCOPM",
      "address": "0xacf8D012Fb6245aFD475E3ecae90cFAfC2c601A3"
    }
  ],
  "code": "OK"
}

If you see 401 Unauthorized, double-check your API key. Save the wallet id from the response — you'll need it for operations like Payins, Payouts, and Bridges.

Step 3: List your bank accounts

Retrieve your registered bank accounts. You'll need a bank account ID for Orders (tokenize/redeem):

Production

GET/v1/bank_accounts

curl https://api.minteo.finance/v1/bank_accounts \
-H "Authorization: Bearer YOUR_API_KEY"

Sandbox

GET/v1/bank_accounts

curl https://api.sandbox.minteo.finance/v1/bank_accounts \
-H "Authorization: Bearer YOUR_API_KEY"

Now you have all the IDs you need to start operating with the API.

Step 4: Set up Webhooks (optional)

Instead of polling for status changes, configure webhooks to get notified automatically when events happen (payin completed, payout failed, etc.).

See the Webhooks guide to set up webhook endpoints and start receiving events.

How money flows through Minteo

Collect funds from end-users:
[End-user bank] ──Payin──> [Minteo] ──tokens──> [Your wallet]

Send funds to third parties:
[Your wallet] ──tokens──> [Minteo] ──Payout──> [Third-party bank]

Tokenize your own funds:
[Your bank] ──fiat──> [Minteo] ──Order(TOKENIZE)──> [Your wallet]

Redeem to your own bank:
[Your wallet] ──Order(REDEEM)──> [Minteo] ──fiat──> [Your bank]

What's next?

Now that you're connected, choose the operation you need:

• Create a Payin — Collect funds from an end-user via PSE
• Create a Payout — Send funds to a third party's bank account
• Create an Order — Tokenize or redeem stablecoins between your own accounts
• Create a Bridge — Transfer tokens between your wallets
• Sandbox Environment — Sandbox-specific details and test values
• API Errors — Handle errors properly