Skip to main content

​
M.O.N.K.Y API Reference

Welcome to the M.O.N.K.Y API documentation! Our API allows you to integrate with M.O.N.K.Y services, interact with our Telegram bot, and access wallet functionalities programmatically.
Beta API: The M.O.N.K.Y API is currently in beta. Features and endpoints may change. Join our Telegram for the latest updates.

​
Base URL

https://api.monkywallet.com/v1

​
Authentication

All API requests require authentication using an API key. Include your API key in the request headers: 
curl -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     https://api.monkywallet.com/v1/wallet/balance

​
Getting Your API Key

1

Connect to Telegram Bot

Start a conversation with our Telegram Bot
2

Request API Access

Send /api command to request developer access
3

Verify Identity

Complete the verification process
4

Receive API Key

Get your unique API key via secure message

​
Rate Limiting

API requests are rate limited to ensure fair usage:

Free Tier

  • 100 requests/hour
  • Basic wallet operations
  • Community support

Pro Tier

  • 1,000 requests/hour
  • Advanced features
  • Priority support
  • Webhook access

​
Response Format

All API responses follow a consistent JSON format: 
{
  "success": true,
  "data": {
    // Response data here
  },
  "message": "Operation completed successfully",
  "timestamp": "2024-10-24T07:37:42Z"
}

​
Error Responses

When an error occurs, the API returns: 
{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "The request parameters are invalid",
    "details": "Missing required field: address"
  },
  "timestamp": "2024-10-24T07:37:42Z"
}

​
Common Error Codes

CodeStatusDescription
INVALID_API_KEY401API key is missing or invalid
RATE_LIMIT_EXCEEDED429Too many requests
INVALID_REQUEST400Request format or parameters are invalid
WALLET_NOT_FOUND404Specified wallet does not exist
INSUFFICIENT_FUNDS422Not enough balance for transaction
NETWORK_ERROR503Solana network is temporarily unavailable

​
Core Endpoints

​
Wallet Operations

Get Balance

Retrieve wallet balance for SOL and SPL tokens

Send Transaction

Send SOL or SPL tokens to another address

Transaction History

Get transaction history for a wallet

Create Wallet

Generate a new Solana wallet

​
Trading & DeFi

Token Swap

Swap between SOL and SPL tokens

Stake SOL

Stake SOL with validators

Get Prices

Real-time token price data

Pool Info

Liquidity pool information

​
Bot Integration

Send Message

Send messages via Telegram bot

User Commands

Handle user commands and interactions

Notifications

Set up transaction notifications

Webhooks

Configure webhook endpoints

​
SDK Examples

​
JavaScript/TypeScript

import { MonkyAPI } from '@monky/api-sdk';

const monky = new MonkyAPI({
  apiKey: 'your-api-key',
  network: 'mainnet' // or 'devnet'
});

// Get wallet balance
const balance = await monky.wallet.getBalance('WALLET_ADDRESS');
console.log(`SOL Balance: ${balance.sol}`);

// Send transaction
const tx = await monky.wallet.sendTransaction({
  from: 'SENDER_ADDRESS',
  to: 'RECIPIENT_ADDRESS',
  amount: 0.1, // SOL
  token: 'SOL'
});

​
Python

from monky_api import MonkyClient

client = MonkyClient(
    api_key='your-api-key',
    network='mainnet'
)

# Get wallet balance
balance = client.wallet.get_balance('WALLET_ADDRESS')
print(f"SOL Balance: {balance['sol']}")

# Send transaction
tx = client.wallet.send_transaction(
    from_address='SENDER_ADDRESS',
    to_address='RECIPIENT_ADDRESS',
    amount=0.1,
    token='SOL'
)

​
curl

# Get wallet balance
curl -X GET \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  "https://api.monkywallet.com/v1/wallet/balance?address=WALLET_ADDRESS"

# Send transaction
curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from":"SENDER_ADDRESS","to":"RECIPIENT_ADDRESS","amount":0.1,"token":"SOL"}' \
  "https://api.monkywallet.com/v1/wallet/send"

​
Webhooks

Set up webhooks to receive real-time notifications: 
{
  "url": "https://your-app.com/webhooks/monky",
  "events": [
    "transaction.confirmed",
    "balance.updated", 
    "stake.reward"
  ],
  "secret": "your-webhook-secret"
}

​
Need Help?

Telegram Bot

Get instant help and support through our bot

Developer Support

Technical support for API integration

Community

Join our developer community
Pro Tip: Use our Telegram Bot to test API functionality before integrating into your application!
⌘I