Authentication

Most ET10 exchange endpoints are public (token list, quotes, deposit addresses, status checks).

For programmatic purchases, use an API Key via the X-API-Key header. This skips CSRF/Origin validation — perfect for bots, AI agents, and automated systems.

# API Key auth (recommended for bots/agents/SDKs)
curl -X POST https://cymetica.com/api/v1/rst/buy-et10 \
  -H "X-API-Key: evt_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"recipient_address":"0x...","token_symbol":"ETH"}'

# /deposit-intent accepts EITHER header — X-API-Key or a Bearer JWT
curl -X POST https://cymetica.com/api/v1/rst/deposit-intent \
  -H "X-API-Key: $ET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rst_address":"0x...","token_symbol":"ETH"}'

# same endpoint, browser-session auth
curl -X POST https://cymetica.com/api/v1/rst/deposit-intent \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{"rst_address":"0x...","token_symbol":"ETH"}'

Get your API key from /account → API Keys.

Buy ET10 — Single Call

The fastest way to buy ET10 programmatically. One call, no bot-registration step required — you do not have to register a bot or an app to use it. Authentication is optional but changes the limits: send your API key in X-API-Key for programmatic access (higher rate limit, no CSRF/Origin check), or call it from a browser with a CSRF token (lower per-IP rate limit).

curl -X POST https://cymetica.com/api/v1/rst/buy-et10 \
  -H "X-API-Key: evt_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient_address": "0xYourWalletAddress",
    "token_symbol": "USDC"
  }'

import requests

resp = requests.post(
    "https://cymetica.com/api/v1/rst/buy-et10",
    headers={"X-API-Key": "evt_YOUR_KEY"},
    json={
        "recipient_address": "0xYourWalletAddress",
        "token_symbol": "USDC"
    }
).json()

print(f"Send USDC to: {resp['deposit_address']}")
print(f"Chain: {resp['chain']} (ID: {resp['chain_id']})")
print(resp["instructions"])

const resp = await fetch("https://cymetica.com/api/v1/rst/buy-et10", {
  method: "POST",
  headers: {
    "X-API-Key": "evt_YOUR_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    recipient_address: "0xYourWalletAddress",
    token_symbol: "USDC"
  })
}).then(r => { if (!r.ok) throw new Error(r.status); return r.json(); });

console.log(`Send USDC to: ${resp.deposit_address}`);
console.log(resp.instructions);

// MCP Tool: et_buy_et10
{
  "name": "et_buy_et10",
  "arguments": {
    "recipient_address": "0xYourWalletAddress",
    "token_symbol": "USDC"
  }
}

// Response:
// { "success": true, "deposit_address": "0x...", "instructions": "..." }

{
  "status": "ok",
  "intent_id": 376,
  "recipient_address": "0xYourWalletAddress",
  "deposit_address": "0xDepositAddressReturnedByAPI",
  "token_symbol": "USDC",
  "chain": "Ethereum",
  "chain_id": 1,
  "et10_price": "$0.001",
  "instructions": "Send USDC to 0x9378... — ET10 will be delivered to 0xYour... automatically."
}

Public Endpoints

No authentication required. Use these for token discovery, price quotes, deposit addresses, and status tracking.

curl https://cymetica.com/api/v1/rst/supported-tokens

import requests
tokens = requests.get("https://cymetica.com/api/v1/rst/supported-tokens").json()
for t in tokens["tokens"][:5]:
    print(f"{t['symbol']:6s} {t['name']:20s} {t['chain']}")

const data = await fetch("https://cymetica.com/api/v1/rst/supported-tokens").then(r => { if (!r.ok) throw new Error(r.status); return r.json(); });
data.tokens.slice(0, 5).forEach(t =>
  console.log(`${t.symbol} - ${t.name} (${t.chain})`)
);

{
  "tokens": [
    {
      "rank": 1,
      "symbol": "BTC",
      "name": "Bitcoin",
      "address": "0x...",
      "decimals": 8,
      "chain": "Ethereum",
      "chain_id": 1,
      "category": "major",
      "logoUrl": "https://s2.coinmarketcap.com/static/img/coins/64x64/1.png"
    },
    ...
  ],
  "rst_price_usd": "0.001"
}

curl https://cymetica.com/api/v1/rst/exchange-address/ETH

addr = requests.get("https://cymetica.com/api/v1/rst/exchange-address/ETH").json()
print(f"Send ETH to: {addr['deposit_address']} on {addr['chain']}")

const addr = await fetch("https://cymetica.com/api/v1/rst/exchange-address/ETH").then(r => { if (!r.ok) throw new Error(r.status); return r.json(); });
console.log(`Send ETH to: ${addr.deposit_address} on ${addr.chain}`);

curl "https://cymetica.com/api/v1/rst/0xRST_ADDRESS/quote-token?token=ETH&amount=1.5"

quote = requests.get(
    "https://cymetica.com/api/v1/rst/0xRST_ADDRESS/quote-token",
    params={"token": "ETH", "amount": "1.5"}
).json()
print(f"1.5 ETH (${quote['usd_value']}) = {quote['rst_amount']} ET10")

const quote = await fetch(
  "https://cymetica.com/api/v1/rst/0xRST_ADDRESS/quote-token?token=ETH&amount=1.5"
).then(r => { if (!r.ok) throw new Error(r.status); return r.json(); });
console.log(`1.5 ETH ($${quote.usd_value}) = ${quote.rst_amount} ET10`);

{
  "token_symbol": "ETH",
  "token_amount": "1.5",
  "token_price_usd": "3200.50",
  "usd_value": "4800.75",
  "rst_amount": "4800750",
  "rst_price_usd": "0.001"
}

curl "https://cymetica.com/api/v1/rst/deposit-status/ETH?recipient=0xYOUR_ADDRESS"

status = requests.get(
    "https://cymetica.com/api/v1/rst/deposit-status/ETH",
    params={"recipient": "0xYOUR_ADDRESS"},  # required
).json()
print(f"Status: {status['status']}")
if status.get("tx_hash"):
    print(f"Tx: https://etherscan.io/tx/{status['tx_hash']}")

// `recipient` is required — without it the request returns 400.
const status = await fetch("https://cymetica.com/api/v1/rst/deposit-status/ETH?recipient=0xYOUR_ADDRESS").then(r => { if (!r.ok) throw new Error(r.status); return r.json(); });
console.log(`Status: ${status.status}`);
if (status.tx_hash) console.log(`Tx: https://etherscan.io/tx/${status.tx_hash}`);

Authenticated Endpoints

These endpoints require authentication: either a Bearer token (JWT session) or an API key via the X-API-Key header. Bots should use X-API-Key — it also skips CSRF validation. Used for creating deposit intents and tracking individual user deposits.

# Bot / programmatic (API key — export ET_API_KEY=evt_... first):
curl -X POST https://cymetica.com/api/v1/rst/deposit-intent \
  -H "X-API-Key: $ET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rst_address":"0xRST_ADDRESS","token_symbol":"ETH"}'

# Browser session (Bearer JWT):
curl -X POST https://cymetica.com/api/v1/rst/deposit-intent \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"rst_address":"0xRST_ADDRESS","token_symbol":"ETH"}'

intent = requests.post(
    "https://cymetica.com/api/v1/rst/deposit-intent",
    headers={"Authorization": "Bearer YOUR_TOKEN"},
    json={"rst_address": "0xRST_ADDRESS", "token_symbol": "ETH"}
).json()
print(f"Send ETH to: {intent['deposit_address']}")

const intent = await fetch("https://cymetica.com/api/v1/rst/deposit-intent", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ rst_address: "0xRST_ADDRESS", token_symbol: "ETH" })
}).then(r => { if (!r.ok) throw new Error(r.status); return r.json(); });
console.log(`Send ETH to: ${intent.deposit_address}`);

curl https://cymetica.com/api/v1/rst/deposit-intent/42 \
  -H "X-API-Key: $ET_API_KEY"
# or: -H "Authorization: Bearer YOUR_TOKEN"

status = requests.get(
    "https://cymetica.com/api/v1/rst/deposit-intent/42",
    headers={"X-API-Key": "evt_YOUR_KEY"}  # or Authorization: Bearer YOUR_TOKEN
).json()
print(f"Intent #{status['id']}: {status['status']}")

curl https://cymetica.com/api/v1/rst/deposit-intents \
  -H "Authorization: Bearer YOUR_TOKEN"

Status Tracking

After sending crypto to the deposit address, poll the status endpoint to track progress. The state machine flows through these states:

Pricing & Conversion Terms

Polling Example

Note: deposit-status/{token} resolves by token + recipient, which is ambiguous if you run multiple concurrent intents for the same token and recipient. Bots should prefer the authenticated per-intent endpoint GET /deposit-intent/{intent_id} (see above, works with X-API-Key).

import time, requests

BASE = "https://cymetica.com/api/v1/rst"
RECIPIENT = "0xYOUR_ADDRESS"  # required — scopes the lookup to your intents

# Poll every 10 seconds until completed or failed
while True:
    status = requests.get(
        f"{BASE}/deposit-status/ETH", params={"recipient": RECIPIENT}
    ).json()
    print(f"Status: {status['status']}")

    if status["status"] == "completed":
        print(f"Received {status['rst_received']} ET10!")
        print(f"Tx: https://etherscan.io/tx/{status['tx_hash']}")
        break
    elif status["status"] == "failed":
        print("Deposit failed — contact support")
        break

    time.sleep(10)

MCP Integration

7 MCP tools for AI agents using any MCP-compatible client (Claude Code, Cursor, IDE plugins, etc.). Every tool authenticates with the API key from your MCP config (EVENT_TRADER_API_KEY; ET_API_KEY also accepted from v1.1.2) — including et_rst_create_intent.

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "event-trader": {
      "command": "uvx",
      "args": ["cymetica-eventtrader-mcp"],
      "env": {
        "EVENT_TRADER_API_URL": "https://cymetica.com",
        "EVENT_TRADER_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Once configured, ask Claude: "List all tokens I can exchange for ET10" or "Quote me 0.1 ETH to ET10".

DCA Bot Skeleton (intent + polling)

A Python skeleton for dollar-cost averaging into ET10. It covers the platform side: quote → create intent → poll by intent_id until delivery. It does not send crypto or schedule runs — step 3 is where you plug in your own wallet library (web3.py, bitcoinlib, solana-py, …) to sign and send the deposit, and recurrence is up to your scheduler (cron, systemd timer, …).

#!/usr/bin/env python3
"""ET10 DCA bot skeleton — intent creation + status polling.

You supply: (a) the wallet signing/sending in step 3, and (b) the
recurring schedule (run this from cron or a timer for true DCA).
"""

import time
import requests

BASE = "https://cymetica.com/api/v1/rst"
RST_ADDRESS = "0xYOUR_RST_ADDRESS"
TOKEN = "ETH"
# Your API key (evt_...) goes in the X-API-Key header — NOT as a Bearer token.
# Bearer is for a JWT session token; an API key sent as Bearer will NOT
# authenticate you.
API_KEY = "YOUR_API_KEY"
HEADERS = {"X-API-Key": API_KEY, "Content-Type": "application/json"}

def buy_et10():
    # 1. Get an indicative quote (prices at request time — not a locked rate;
    #    the final ET10 amount is computed from what actually arrives)
    quote = requests.get(
        f"{BASE}/{RST_ADDRESS}/quote-token",
        params={"token": TOKEN, "amount": "0.01"}
    ).json()
    print(f"Quote: 0.01 {TOKEN} = {quote['rst_amount']} ET10 (${quote['usd_value']})")

    # 2. Create deposit intent (X-API-Key authenticated)
    intent = requests.post(
        f"{BASE}/deposit-intent",
        headers=HEADERS,
        json={"rst_address": RST_ADDRESS, "token_symbol": TOKEN}
    ).json()
    intent_id = intent["intent_id"]
    # intent["chain"] is the DEPOSIT chain; ET10 is delivered on Ethereum mainnet.
    print(f"Intent #{intent_id}: send {TOKEN} to {intent['deposit_address']} ({intent['chain']})")

    # 3. YOUR CODE HERE: sign + send 0.01 TOKEN to intent["deposit_address"]
    #    with your wallet library. Nothing happens until the deposit lands.

    # 4. Poll THIS intent by id — unambiguous even with multiple concurrent
    #    intents for the same token/recipient.
    for _ in range(60):  # 10 minutes max
        status = requests.get(
            f"{BASE}/deposit-intent/{intent_id}", headers=HEADERS
        ).json()
        if status["status"] == "completed":
            print(f"Received {status['rst_received']} ET10!")
            print(f"Tx: https://etherscan.io/tx/{status['tx_hash']}")
            return True
        elif status["status"] == "failed":
            print("Failed — deposited funds are safe; contact support with the intent id")
            return False
        time.sleep(10)
    return False

if __name__ == "__main__":
    buy_et10()

Troubleshooting

Error Codes

Rate Limits