เริ่มต้นอย่างรวดเร็ว
ให้ AI agent ของคุณเริ่มชำระเงินได้ภายในไม่ถึง 5 นาที
ติดตั้ง MCP server
ติดตั้ง BananaCrystal MCP server แบบ global ผ่าน npm
npm install -g @bananacrystal/mcp-serverรับ API key ของคุณ
สร้าง MCP API key จากแดชบอร์ดบัญชีของคุณ Sandbox key ขึ้นต้นด้วย bc_test_ และใช้ฟรี
bc_test_...ตั้งค่า Claude Desktop
เพิ่ม BananaCrystal ลงในไฟล์การตั้งค่า Claude Desktop ของคุณ
{
"mcpServers": {
"bananacrystal": {
"command": "bananacrystal-mcp",
"env": {
"BANANACRYSTAL_API_KEY": "bc_test_your_sandbox_key_here"
}
}
}
}ถามเอเจนต์ของคุณ
ตอนนี้เอเจนต์ของคุณมีเครื่องมือชำระเงิน 40 รายการแล้ว ลองใช้คำสั่งเหล่านี้:
เครื่องมือ MCP
เครื่องมือชำระเงินพร้อมใช้งานจริง 40 รายการใน 6 หมวดหมู่ การดำเนินการแบบอ่านอย่างเดียวใช้ฟรีเสมอ
pingget_server_infoechoget_my_profileget_balancesget_exchange_ratelist_supported_currencieslist_available_tokensget_transaction_historyget_my_limitsestimate_swap_feesget_agent_configcheck_approval_statusget_kyc_statusget_deposit_statusget_withdrawal_statusget_escrow_balancesget_escrow_historylist_offersget_offerget_my_offerslist_tradesget_tradeget_my_tradesrequest_transfer_otptransfer_tokensswap_currencyinitiate_kycinitiate_depositrequest_withdrawalcreate_offerupdate_offerdelist_offerdelete_offerengage_offercancel_traderequest_agent_transactionexecute_approved_transactionupdate_my_agent_settingsreset_sandbox_balanceRate API
การดำเนินการด้านอัตราสกุลเงินขั้นสูงผ่าน REST ต้องใช้ API key ที่มีขอบเขต rate
เครื่องมือ MCP กับ Rate API ต่างกันอย่างไร
MCP server มี get_exchange_rate เป็นเครื่องมือ read_only อยู่แล้ว: เอเจนต์ของคุณเรียกใช้ได้โดยตรงเพื่อดูอัตราซื้อ/ขายของสกุลเงินหนึ่งเทียบกับ USD ซึ่งครอบคลุมกรณีการใช้งานส่วนใหญ่ของเอเจนต์
Rate API ทำได้มากกว่านั้น: การแปลงข้ามคู่สกุลเงิน การดำเนินการแบบกลุ่ม ข้อมูลย้อนหลังแบบอนุกรมเวลา และสรุปสถิติ ทั้งหมดนี้ใช้ได้ผ่าน HTTP endpoint โดยตรง ยืนยันตัวตนด้วย API key ที่มีขอบเขต rate สร้าง rate key ได้จากแดชบอร์ดบัญชีของคุณ
การยืนยันตัวตน
Rate API endpoint ทั้งหมดต้องใช้ API key ที่มีขอบเขต rate ส่งผ่าน header x-api-key เวอร์ชัน sandbox อยู่ที่ /mcp/sandbox/rate/* และใช้ sandbox key ของคุณ (bc_test_...) พร้อมอัตราจำลองคงที่เพื่อการทดสอบที่ให้ผลซ้ำได้
/mcp/rate/currenciesแสดงสกุลเงินที่รองรับทั้งหมด
ตัวอย่างคำขอ
curl "https://agentic.bananacrystal.com/mcp/rate/currencies" \
-H "x-api-key: bc_live_your_rate_key_here"ตัวอย่างการตอบกลับ
{
"count": 11,
"currencies": ["EGP", "EUR", "GBP", "GHS", "KES", "NGN", "TZS", "UGX", "USD", "XOF", "ZAR"]
}/mcp/rate/currentดึงอัตราแลกเปลี่ยนปัจจุบันระหว่างสองสกุลเงิน
พารามิเตอร์
| ชื่อ | จำเป็น | คำอธิบาย |
|---|---|---|
from | จำเป็น | รหัสสกุลเงินต้นทาง (เช่น USD) |
to | จำเป็น | รหัสสกุลเงินปลายทาง (เช่น NGN) |
ตัวอย่างคำขอ
curl "https://agentic.bananacrystal.com/mcp/rate/current?from=USD&to=NGN" \
-H "x-api-key: bc_live_your_rate_key_here"ตัวอย่างการตอบกลับ
{
"from": "USD",
"to": "NGN",
"rate": 1584.75,
"buyRate": 1590.0,
"sellRate": 1579.5,
"timestamp": "2026-04-30T10:22:00.000Z"
}/mcp/rate/convertแปลงจำนวนเงินจากสกุลเงินหนึ่งเป็นอีกสกุลเงินหนึ่ง
พารามิเตอร์
| ชื่อ | จำเป็น | คำอธิบาย |
|---|---|---|
from | จำเป็น | รหัสสกุลเงินต้นทาง |
to | จำเป็น | รหัสสกุลเงินปลายทาง |
amount | จำเป็น | จำนวนที่ต้องการแปลง (ตัวเลข) |
ตัวอย่างคำขอ
curl "https://agentic.bananacrystal.com/mcp/rate/convert?from=USD&to=NGN&amount=100" \
-H "x-api-key: bc_live_your_rate_key_here"ตัวอย่างการตอบกลับ
{
"from": "USD",
"to": "NGN",
"amount": 100,
"converted": 158475.0,
"rate": 1584.75,
"timestamp": "2026-04-30T10:22:00.000Z"
}/mcp/rate/batch-convertแปลงจำนวนเงินหลายสกุลในคำขอเดียว (สูงสุด 100)
ตัวอย่างคำขอ
curl -X POST "https://agentic.bananacrystal.com/mcp/rate/batch-convert" \
-H "x-api-key: bc_live_your_rate_key_here" \
-H "Content-Type: application/json" \
-d '{
"conversions": [
{ "from": "USD", "to": "NGN", "amount": 100 },
{ "from": "USD", "to": "GHS", "amount": 50 },
{ "from": "EUR", "to": "GBP", "amount": 200 }
]
}'ตัวอย่างการตอบกลับ
[
{ "from": "USD", "to": "NGN", "amount": 100, "converted": 158475.0, "rate": 1584.75, "timestamp": "..." },
{ "from": "USD", "to": "GHS", "amount": 50, "converted": 800.0, "rate": 16.0, "timestamp": "..." },
{ "from": "EUR", "to": "GBP", "amount": 200, "converted": 172.0, "rate": 0.86, "timestamp": "..." }
]/mcp/rate/historyดึงอัตราแลกเปลี่ยนย้อนหลังของคู่สกุลเงิน
พารามิเตอร์
| ชื่อ | จำเป็น | คำอธิบาย |
|---|---|---|
from | จำเป็น | รหัสสกุลเงินต้นทาง |
to | จำเป็น | รหัสสกุลเงินปลายทาง |
startDate | จำเป็น | วันที่เริ่มต้น (ISO 8601 เช่น 2026-04-01) |
endDate | จำเป็น | วันที่สิ้นสุด (ISO 8601 เช่น 2026-04-30) |
ตัวอย่างคำขอ
curl "https://agentic.bananacrystal.com/mcp/rate/history?from=USD&to=NGN&startDate=2026-04-01&endDate=2026-04-30" \
-H "x-api-key: bc_live_your_rate_key_here"ตัวอย่างการตอบกลับ
[
{ "date": "2026-04-01T00:00:00.000Z", "from": "USD", "to": "NGN", "buyRate": 1580.0, "sellRate": 1575.0, "midRate": 1577.5 },
{ "date": "2026-04-02T00:00:00.000Z", "from": "USD", "to": "NGN", "buyRate": 1582.0, "sellRate": 1577.0, "midRate": 1579.5 }
]/mcp/rate/statsดึงสถิติอัตรา (สูงสุด ต่ำสุด เฉลี่ย ล่าสุด) ในช่วงเวลาที่กำหนด
พารามิเตอร์
| ชื่อ | จำเป็น | คำอธิบาย |
|---|---|---|
from | จำเป็น | รหัสสกุลเงินต้นทาง |
to | จำเป็น | รหัสสกุลเงินปลายทาง |
days | ไม่บังคับ | ช่วงเวลาเป็นวัน 1 ถึง 365 (ค่าเริ่มต้น: 30) |
ตัวอย่างคำขอ
curl "https://agentic.bananacrystal.com/mcp/rate/stats?from=USD&to=NGN&days=30" \
-H "x-api-key: bc_live_your_rate_key_here"ตัวอย่างการตอบกลับ
{
"from": "USD",
"to": "NGN",
"period": "30d",
"high": 1598.0,
"low": 1560.0,
"avg": 1581.4,
"latest": 1584.75,
"count": 30
}Sandbox Rate API
แทนที่ /mcp/rate/ ด้วย /mcp/sandbox/rate/ และใช้ sandbox key ของคุณเพื่อรับอัตราจำลองคงที่ ข้อมูลย้อนหลังสร้างขึ้นโดยมีความผันแปร ±2% เพื่อการทดสอบที่สมจริง ไม่ใช้ข้อมูลอัตราแลกเปลี่ยนจริง
สภาพแวดล้อม Sandbox
ทดสอบการเชื่อมต่อของคุณอย่างปลอดภัยด้วยยอดคงเหลือที่ตั้งไว้ล่วงหน้าและไม่ใช้เงินจริง
Sandbox คืออะไร
Sandbox คือสภาพแวดล้อมทดสอบที่แยกออกมาโดยสมบูรณ์และเหมือนกับ production ทุกประการ ทั้งเครื่องมือ API และรูปแบบการตอบกลับ ไม่มีการเคลื่อนย้ายเงินจริง Sandbox API key ขึ้นต้นด้วย bc_test_ และเชื่อมต่อกับ Hedera testnet
ยอดคงเหลือที่ตั้งไว้ล่วงหน้า
บัญชี sandbox ทุกบัญชีเริ่มต้นด้วยยอดคงเหลือเหล่านี้ ใช้ reset_sandbox_balance เพื่อคืนค่าได้ทุกเมื่อ
| โทเคน | จำนวน | สกุลเงิน |
|---|---|---|
USDb | 10,000 | USD |
NGNb | 5,000,000 | NGN |
GHSb | 50,000 | GHS |
KESb | 1,000,000 | KES |
ZARb | 150,000 | ZAR |
Sandbox เทียบกับ Live
| ฟีเจอร์ | Sandbox | Live |
|---|---|---|
| มีการเคลื่อนย้ายเงินจริง | ไม่มี: จำลองเท่านั้น | มี |
| การยืนยันด้วย OTP | ส่งกลับมาในการตอบกลับของ API | ส่งไปที่อีเมลของคุณ |
| ต้องผ่าน KYC สำหรับเงินเฟียต | ไม่ต้อง | ต้อง |
| บังคับใช้วงเงินการใช้จ่าย | ใช่ (ปรับตั้งค่าได้) | ใช่ |
| คำนำหน้า API key | bc_test_... | bc_live_... |
| การชำระราคาบน Hedera | Testnet | Mainnet |
| ยอดคงเหลือตั้งต้น | มี (รีเซ็ตได้ทุกเมื่อ) | ไม่มี |
| ขีดจำกัดอัตราการเรียกใช้ | ผ่อนปรน | ตามแพ็กเกจ |
OTP ใน sandbox
ในโหมด sandbox รหัส OTP จะส่งกลับมาในการตอบกลับของ API request_transfer_otp โดยตรงแทนการส่งทางอีเมล ทำให้ทดสอบอัตโนมัติได้ง่ายโดยไม่ต้องเข้าถึงอีเมล
การตั้งค่า Sandbox
{
"mcpServers": {
"bananacrystal": {
"command": "bananacrystal-mcp",
"env": {
"BANANACRYSTAL_API_KEY": "bc_test_your_sandbox_key_here",
"BANANACRYSTAL_API_URL": "https://agentic.bananacrystal.com/mcp/sandbox"
}
}
}
}การตั้งค่า
เชื่อมต่อ BananaCrystal กับเครื่องมือหรือเฟรมเวิร์ก AI ที่คุณใช้
{
"mcpServers": {
"bananacrystal": {
"command": "bananacrystal-mcp",
"env": {
"BANANACRYSTAL_API_KEY": "your_api_key_here"
}
}
}
}ตัวแปรสภาพแวดล้อม
BANANACRYSTAL_API_KEYจำเป็นMCP API key ของคุณ Sandbox key ขึ้นต้นด้วย bc_test_ ส่วน live key ขึ้นต้นด้วย bc_live_
ค่าเริ่มต้น: N/A
BANANACRYSTAL_API_URLไม่บังคับระบุ URL ของ MCP endpoint แทนค่าเริ่มต้น ใช้ URL ของ sandbox สำหรับการทดสอบ
ค่าเริ่มต้น: https://agentic.bananacrystal.com/mcp
DEBUGไม่บังคับตั้งเป็น true เพื่อเปิดการบันทึกคำขอและการตอบกลับแบบละเอียด
ค่าเริ่มต้น: false
| ตัวแปร | จำเป็น | ค่าเริ่มต้น | คำอธิบาย |
|---|---|---|---|
BANANACRYSTAL_API_KEY | จำเป็น | N/A | MCP API key ของคุณ Sandbox key ขึ้นต้นด้วย bc_test_ ส่วน live key ขึ้นต้นด้วย bc_live_ |
BANANACRYSTAL_API_URL | ไม่บังคับ | https://agentic.bananacrystal.com/mcp | ระบุ URL ของ MCP endpoint แทนค่าเริ่มต้น ใช้ URL ของ sandbox สำหรับการทดสอบ |
DEBUG | ไม่บังคับ | false | ตั้งเป็น true เพื่อเปิดการบันทึกคำขอและการตอบกลับแบบละเอียด |
การเชื่อมต่อกับเฟรมเวิร์ก
ตัวอย่างพร้อมรันสำหรับเฟรมเวิร์ก AI agent ยอดนิยม
import asyncio
from langchain_mcp_adapters.client import MultiServerMCPClient
from langchain.agents import create_tool_calling_agent, AgentExecutor
from langchain_anthropic import ChatAnthropic
from langchain_core.prompts import ChatPromptTemplate
async def main():
# Connect to BananaCrystal MCP server
client = MultiServerMCPClient({
"bananacrystal": {
"url": "https://agentic.bananacrystal.com/mcp",
"transport": "streamable_http",
"headers": {
"Authorization": "Bearer your_api_key_here"
}
}
})
# Get all 40 payment tools
tools = await client.get_tools()
# Create an agent with payment capabilities
llm = ChatAnthropic(model="claude-3-5-sonnet-20241022")
prompt = ChatPromptTemplate.from_messages([
("system", "You are a payment agent. Use the BananaCrystal tools to help users manage their finances."),
("human", "{input}"),
("placeholder", "{agent_scratchpad}"),
])
agent = create_tool_calling_agent(llm, tools, prompt)
executor = AgentExecutor(agent=agent, tools=tools, verbose=True)
# Run the agent
result = await executor.ainvoke({
"input": "What is my current USDb balance?"
})
print(result["output"])
asyncio.run(main())เฟรมเวิร์กใดก็ได้ที่รองรับ MCP ใช้งานได้ หากเฟรมเวิร์กของคุณรองรับ MCP server แบบ HTTP ให้ชี้ไปที่ https://agentic.bananacrystal.com/mcp โดยใช้ API key ของคุณเป็น Bearer token
สถาปัตยกรรมความปลอดภัย
การป้องกันหลายชั้น เพื่อให้เอเจนต์ของคุณทำได้เฉพาะสิ่งที่คุณอนุญาตไว้อย่างชัดเจน
ขอบเขตของ API Key
API key แต่ละตัวมีขอบเขตสิทธิ์ที่ชัดเจน เอเจนต์ดำเนินการได้เฉพาะภายในขอบเขตที่คุณให้ไว้เท่านั้น
วงเงินการใช้จ่าย
กำหนดยอดสูงสุดต่อธุรกรรมและเพดานสะสม 24 ชั่วโมงต่อ API key อย่างเข้มงวด บังคับใช้ที่ระดับโครงสร้างพื้นฐาน
การยืนยันด้วย OTP
การโอนโทเคนทุกครั้งต้องใช้ OTP 6 หลักที่ส่งไปยังอีเมลที่คุณลงทะเบียนไว้ เอเจนต์ไม่สามารถโอนให้เสร็จได้หากคุณไม่ให้รหัสนั้น
การจำกัดอัตรา
เพดานอัตราต่อคีย์ต่อนาทีป้องกันไม่ให้เอเจนต์ที่ทำงานผิดปกติส่งคำขอถล่ม API ขีดจำกัดเพิ่มขึ้นตามระดับแพ็กเกจของคุณ
ประวัติการตรวจสอบที่แก้ไขไม่ได้
การเรียกใช้เครื่องมือทุกครั้งจะถูกบันทึกลงในชั้นฉันทามติของ Hedera มีเวลาประทับ ป้องกันการแก้ไข และตรวจสอบได้แบบสาธารณะบน on-chain ดูประวัติการตรวจสอบทั้งหมดได้ผ่าน get_transaction_history
ขั้นตอนอนุมัติของเอเจนต์
ธุรกรรมระหว่างเอเจนต์สามารถกำหนดให้ต้องได้รับการอนุมัติทางอีเมลจากมนุษย์ก่อนดำเนินการ ใช้ update_my_agent_settings เพื่อตั้งค่า require_human_approval
ขอบเขตของ API Key
ตรวจสอบยอดคงเหลือ อัตรา ประวัติ และวงเงิน โดยไม่เคลื่อนย้ายเงิน
ส่งโทเคนไปยังบัญชีอื่น (ต้องใช้ OTP)
แลกเปลี่ยนระหว่าง stablecoin สกุลเงินต่าง ๆ
ฝากและถอนเงินเฟียต (ต้องผ่าน KYC)
สร้างและจัดการข้อเสนอและการเทรดในตลาดการทำนาย
เข้าถึงอัตราแลกเปลี่ยนสกุลเงิน ข้อมูลย้อนหลัง การแปลง และสถิติอัตรา
| ขอบเขต | สิ่งที่อนุญาต |
|---|---|
| read_only | ตรวจสอบยอดคงเหลือ อัตรา ประวัติ และวงเงิน โดยไม่เคลื่อนย้ายเงิน |
| transfer | ส่งโทเคนไปยังบัญชีอื่น (ต้องใช้ OTP) |
| swap | แลกเปลี่ยนระหว่าง stablecoin สกุลเงินต่าง ๆ |
| fiat | ฝากและถอนเงินเฟียต (ต้องผ่าน KYC) |
| offers | สร้างและจัดการข้อเสนอและการเทรดในตลาดการทำนาย |
| rate | เข้าถึงอัตราแลกเปลี่ยนสกุลเงิน ข้อมูลย้อนหลัง การแปลง และสถิติอัตรา |
ราคา
การดำเนินการแบบอ่านอย่างเดียวใช้ฟรีเสมอ จ่ายเฉพาะธุรกรรมที่เคลื่อนย้ายมูลค่า
ค่าธรรมเนียมการดำเนินการ
การดำเนินการแบบอ่านอย่างเดียว
get_balances, get_exchange_rate, list_trades, …
การโอนโทเคน
transfer_tokens
การแลกเปลี่ยนสกุลเงิน
swap_currency
การฝากเงินเฟียต
initiate_deposit
การถอนเงินเฟียต
request_withdrawal
ตลาดการทำนาย
create_offer, engage_offer
| การดำเนินการ | เครื่องมือ | ค่าธรรมเนียม |
|---|---|---|
| การดำเนินการแบบอ่านอย่างเดียว | get_balances, get_exchange_rate, list_trades, … | ฟรี |
| การโอนโทเคน | transfer_tokens | 0.3% |
| การแลกเปลี่ยนสกุลเงิน | swap_currency | 0.5% |
| การฝากเงินเฟียต | initiate_deposit | แตกต่างกันตามช่องทาง |
| การถอนเงินเฟียต | request_withdrawal | แตกต่างกันตามช่องทาง |
| ตลาดการทำนาย | create_offer, engage_offer | ค่าธรรมเนียมแพลตฟอร์มเมื่อชำระราคา |
แพ็กเกจ
ฟรี
เครื่องมือแบบอ่านอย่างเดียวทั้งหมดใช้ฟรีเสมอ ไม่ต้องมีบัญชีเพื่อตรวจสอบอัตราหรือยอดคงเหลือ
- เครื่องมือแบบอ่านอย่างเดียวทั้งหมดฟรีตลอดไป
- มีสภาพแวดล้อม Sandbox ให้
- get_balances, get_exchange_rate และอีก 22 รายการ
- การสนับสนุนจากชุมชน
- ชำระราคาบน Hedera testnet
จ่ายตามการใช้งาน
ขยายตามการเติบโตของคุณ จ่ายเฉพาะที่ใช้
- เรียก API ได้ไม่จำกัด
- 0.3% สำหรับการโอน
- 0.5% สำหรับการแลกเปลี่ยน
- ช่องทางเงินเฟียต (แตกต่างกันตามวิธี)
- การสนับสนุนทางอีเมล + แบบเร่งด่วน
- ชำระราคาบน Hedera mainnet
- ประวัติการตรวจสอบครบถ้วน
Enterprise
ส่วนลดตามปริมาณ SLA และโครงสร้างพื้นฐานเฉพาะ
- ระดับค่าธรรมเนียมแบบกำหนดเอง
- MCP endpoint เฉพาะ
- การรับประกัน SLA
- วงเงินการใช้จ่ายแบบกำหนดเอง
- การสนับสนุนโดยเฉพาะ
- ตัวเลือกติดตั้งในองค์กร
คำถามที่พบบ่อย
คำถามทั่วไปเกี่ยวกับ BananaCrystal และ MCP server
พร้อมมอบกระเป๋าเงินให้เอเจนต์ของคุณแล้วหรือยัง
สร้าง API key และเชื่อมต่อเอเจนต์ของคุณกับเครื่องมือชำระเงิน 40 รายการได้ภายในไม่ถึง 5 นาที เครื่องมือแบบอ่านอย่างเดียวใช้ฟรีเสมอ
รับ API Key