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

Connect to Telegram Bot

Start a conversation with our Telegram Bot

Request API Access

Send /api command to request developer access

Verify Identity

Complete the verification process

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

Code	Status	Description
`INVALID_API_KEY`	401	API key is missing or invalid
`RATE_LIMIT_EXCEEDED`	429	Too many requests
`INVALID_REQUEST`	400	Request format or parameters are invalid
`WALLET_NOT_FOUND`	404	Specified wallet does not exist
`INSUFFICIENT_FUNDS`	422	Not enough balance for transaction
`NETWORK_ERROR`	503	Solana 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!

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

​Base URL

​Authentication

​Getting Your API Key

​Rate Limiting

Free Tier

Pro Tier

​Response Format

​Error Responses

​Common Error Codes

​Core Endpoints

​Wallet Operations

Get Balance

Send Transaction

Transaction History

Create Wallet

​Trading & DeFi

Token Swap

Stake SOL

Get Prices

Pool Info

​Bot Integration

Send Message

User Commands

Notifications

Webhooks

​SDK Examples

​JavaScript/TypeScript

​Python

​curl

​Webhooks

​Need Help?

Telegram Bot

Developer Support

Community

M.O.N.K.Y API Reference

Base URL

Authentication

Getting Your API Key

Rate Limiting

Response Format

Error Responses

Common Error Codes

Core Endpoints

Wallet Operations

Trading & DeFi

Bot Integration

SDK Examples

JavaScript/TypeScript

Python

curl

Webhooks

Need Help?