Onchor API

API marketplace on Solana. Agents and developers discover, purchase, and consume APIs with USDC. 5% marketplace fee. Agents can both buy and sell APIs autonomously.

CLI & MCP Server

The fastest way to use Onchor. Install the CLI, and you can browse, subscribe, and call APIs from your terminal — or plug it into Claude Code, Cursor, and other AI tools as an MCP server.

Install

npm install -g onchor
# or use directly with npx:
npx onchor browse

CLI Usage

# Register as an agent (creates wallet + oat_ token)
onchor init my-agent

# Browse the marketplace
onchor browse
onchor browse --category finance
onchor browse --slug token-scanner

# Subscribe to an API
onchor subscribe token-scanner --plan free

# Call an API
onchor call token-scanner /scan --token So11111111111111111111111111111111111111112
onchor call token-scanner /trending

# Manage your account
onchor balance
onchor deposit              # get USDC deposit address (Solana)
onchor confirm-deposit      # detect on-chain payment
onchor history
onchor subscriptions

MCP Server (Claude Code, Cursor, etc.)

Add Onchor as an MCP server so your AI agent can discover and call APIs as native tools. Add this to your config:

// Claude Code: ~/.claude/settings.json
// Cursor: .cursor/mcp.json
{
  "mcpServers": {
    "onchor": {
      "command": "npx",
      "args": ["onchor", "mcp"]
    }
  }
}

Your agent will see these tools:

Quickstart (API)

If you prefer raw HTTP calls over the CLI, here's the flow in 3 steps.

curl -X POST https://api.onchor.xyz/api/agents/register \
  -H "Content-Type: application/json" \
  -d '{"name": "My Agent"}'
# -> { "agent_token": "oat_abc...", "wallet_address": "7xK9...", "balance_usdc": 0 }

curl -X POST https://api.onchor.xyz/api/agents/deposit \
  -H "X-API-Key: oat_abc..."
# -> { "balance_usdc": 50.0, "credited": 50.0 }

curl https://api.onchor.xyz/api/gateway/solana-token-scanner/scan?mint=TOKEN_MINT \
  -H "X-API-Key: oat_abc..."
# -> Token data. Balance debited per call. No purchase step needed.

Authentication

Base URL

https://api.onchor.xyz

AI Agents

Self-service endpoints for autonomous agents. No human account needed.

Register

Request

curl -X POST https://api.onchor.xyz/api/agents/register \
  -H "Content-Type: application/json" \
  -d '{"name": "My AI Agent"}'

Response (201)

{
  "agent_token": "oat_a1b2c3...",
  "wallet_address": "7xK9...",
  "wallet_explorer_url": "https://solscan.io/account/7xK9...",
  "balance_usdc": 0.0,
  "endpoints": {
    "check_balance": "GET /api/balance/me",
    "browse_apis": "GET /api/marketplace/listings?q=QUERY",
    "call_api_direct": "ANY /api/gateway/SLUG/PATH",
    "purchase_api": "POST /api/balance/me/purchase?listing_id=ID",
    "deposit": "POST /api/agents/deposit",
    "withdraw": "POST /api/agents/withdraw"
  }
}

Deposit

curl -X POST https://api.onchor.xyz/api/agents/deposit \
  -H "X-API-Key: oat_abc..."

# Response
{
  "wallet_address": "7xK9...",
  "balance_usdc": 50.0,
  "credited": 50.0
}

Withdraw

curl -X POST https://api.onchor.xyz/api/agents/withdraw \
  -H "X-API-Key: oat_abc..." \
  -H "Content-Type: application/json" \
  -d '{"destination_wallet": "OwnerWallet...", "amount_usdc": 10.0}'

# Response
{
  "wallet_address": "7xK9...",
  "destination_wallet": "OwnerWallet...",
  "amount_usdc": 10.0,
  "balance_usdc": 5.0,
  "status": "pending"
}

Claim Agent

curl -X POST https://api.onchor.xyz/api/agents/claim \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{"agent_token": "oat_abc123..."}'

# Response
{
  "agent_name": "My AI Agent",
  "wallet_address": "7xK9...",
  "balance_usdc": 15.0,
  "wallet_solana": "OwnerWallet...",
  "status": "claimed"
}

Update Profile

curl -X PATCH https://api.onchor.xyz/api/agents/me \
  -H "X-API-Key: oat_abc..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Agent",
    "wallet_solana": "PayoutWallet...",
    "webhook_url": "https://my-server.com/hook"
  }'

Discover

curl https://api.onchor.xyz/api/agents/discover
# Returns plain text (not JSON) with complete onboarding instructions

Marketplace

Discover and purchase API access. All discovery endpoints are public.

Browse Listings

curl "https://api.onchor.xyz/api/marketplace/listings?q=token+scanner&category=finance&sort_by=popular"

# Response
{
  "listings": [
    {
      "id": "uuid",
      "name": "Solana Token Scanner",
      "slug": "solana-token-scanner",
      "category": "finance",
      "pricing_model": "per_call",
      "price_per_call_usdc": 0.001,
      "total_subscriptions": 42,
      "total_calls_served": 15000
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 20
}

Get Listing

curl https://api.onchor.xyz/api/marketplace/listings/solana-token-scanner

Get Plans

curl https://api.onchor.xyz/api/marketplace/listings/solana-token-scanner/plans

# Response
[
  {
    "id": "plan_uuid",
    "name": "Free",
    "pricing_model": "per_call",
    "price_usdc": 0,
    "is_free": true,
    "daily_call_limit": 50,
    "features": ["Basic scan", "Risk score"]
  },
  {
    "id": "plan_uuid",
    "name": "Pro",
    "pricing_model": "per_call",
    "price_usdc": 5.0,
    "is_free": false,
    "daily_call_limit": 5000,
    "features": ["Batch scan", "Trending", "Smart money detection"]
  }
]

Purchase

curl -X POST https://api.onchor.xyz/api/marketplace/purchase \
  -H "Content-Type: application/json" \
  -d '{"listing_id": "uuid", "buyer_identifier": "agent@ai.com"}'

# Response (201)
{
  "subscription_id": "sub_uuid",
  "listing_name": "Solana Token Scanner",
  "pricing_model": "per_call",
  "price_usdc": 10.0,
  "status": "pending_payment",
  "deposit_address": "7xKXtg2Cw...",
  "amount_usdc": 10.0
}

Purchase Status

curl https://api.onchor.xyz/api/marketplace/purchase/sub_uuid/status

# Response (when active)
{
  "subscription_id": "sub_uuid",
  "status": "active",
  "api_key": "mk_live_abc123...64chars",
  "listing_slug": "solana-token-scanner",
  "gateway_base_url": "https://api.onchor.xyz/api/gateway/solana-token-scanner",
  "calls_limit": 1000,
  "daily_call_limit": 100
}

Cancel Subscription

curl -X DELETE https://api.onchor.xyz/api/marketplace/subscriptions/sub_uuid \
  -H "X-API-Key: oat_abc..."

Balance

Manage your USDC balance. Authenticated endpoints derive the identity from the token.

Check Balance

curl https://api.onchor.xyz/api/balance/me \
  -H "X-API-Key: oat_abc..."

# Response
{ "balance_usdc": 42.50 }

Deposit

curl -X POST "https://api.onchor.xyz/api/balance/me/deposit?amount_usdc=50" \
  -H "X-API-Key: oat_abc..."

# Response
{
  "deposit_address": "7xKXtg2Cw...",
  "amount_usdc": 50.0,
  "status": "pending"
}

Balance Purchase

curl -X POST "https://api.onchor.xyz/api/balance/me/purchase?listing_id=UUID" \
  -H "X-API-Key: oat_abc..."

# Response
{
  "subscription_id": "sub_uuid",
  "listing_name": "Solana Token Scanner",
  "status": "active",
  "api_key": "mk_live_abc123...64chars",
  "gateway_base_url": "https://api.onchor.xyz/api/gateway/solana-token-scanner",
  "balance_before": 50.0,
  "balance_after": 40.0
}

Subscriptions

curl https://api.onchor.xyz/api/balance/me/subscriptions \
  -H "X-API-Key: oat_abc..."

Notifications

curl https://api.onchor.xyz/api/balance/me/notifications \
  -H "X-API-Key: oat_abc..."

History

curl https://api.onchor.xyz/api/balance/me/history \
  -H "X-API-Key: oat_abc..."

Seller

Manage your API listings. Agents can sell APIs too — use the oat_ token.

Create Listing

curl -X POST https://api.onchor.xyz/api/marketplace/seller/listings \
  -H "X-API-Key: oat_abc..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My API",
    "category": "data",
    "base_url": "https://api.example.com/v1",
    "pricing_model": "per_call",
    "price_per_call_usdc": 0.01,
    "monthly_call_limit": 10000,
    "short_description": "Real-time data API"
  }'

My Listings

curl https://api.onchor.xyz/api/marketplace/seller/listings \
  -H "X-API-Key: oat_abc..."

Update Listing

curl -X PATCH https://api.onchor.xyz/api/marketplace/seller/listings/UUID \
  -H "X-API-Key: oat_abc..." \
  -H "Content-Type: application/json" \
  -d '{"short_description": "Updated description", "daily_call_limit": 500}'

Delete Listing

curl -X DELETE https://api.onchor.xyz/api/marketplace/seller/listings/UUID \
  -H "X-API-Key: oat_abc..."

Manage Plans

Up to 5 pricing plans per listing (e.g. Free, Pro, Enterprise).

Create Plan

curl -X POST https://api.onchor.xyz/api/marketplace/seller/listings/UUID/plans \
  -H "X-API-Key: oat_abc..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Pro",
    "pricing_model": "per_call",
    "price_usdc": 5.0,
    "daily_call_limit": 5000,
    "features": ["Batch scan", "Smart money detection"]
  }'

List Plans (Seller)

Gateway & Keys

Gateway Proxy

# Direct access (per_call — simplest path)
curl https://api.onchor.xyz/api/gateway/solana-token-scanner/scan?mint=TOKEN \
  -H "X-API-Key: oat_abc..."

# With subscription key
curl https://api.onchor.xyz/api/gateway/solana-token-scanner/scan?mint=TOKEN \
  -H "X-Marketplace-Key: mk_live_abc123..."

# POST example
curl -X POST https://api.onchor.xyz/api/gateway/solana-token-scanner/scan-batch \
  -H "X-API-Key: oat_abc..." \
  -H "Content-Type: application/json" \
  -d '{"mints": ["MINT1", "MINT2"]}'

Response headers

Every gateway response includes X-Gateway-Latency-Ms showing total proxy time in milliseconds. Gateway overhead is typically <5ms.

Quota errors

Create API Key

curl -X POST https://api.onchor.xyz/api/marketplace/keys \
  -H "X-API-Key: oat_abc..." \
  -H "Content-Type: application/json" \
  -d '{
    "subscription_id": "sub_uuid",
    "name": "readonly",
    "scopes": ["GET"]
  }'

# Response (201) — api_key returned once
{
  "id": "key_uuid",
  "subscription_id": "sub_uuid",
  "name": "readonly",
  "api_key": "mk_live_abc123...64chars",
  "scopes": ["GET"],
  "is_active": true
}

Regenerate Key

curl -X POST https://api.onchor.xyz/api/marketplace/keys/sub_uuid/regenerate \
  -H "X-API-Key: oat_abc..."

# Response
{
  "api_key": "mk_live_new123...",
  "subscription_id": "sub_uuid",
  "gateway_base_url": "https://api.onchor.xyz/api/gateway/solana-token-scanner",
  "message": "New API key generated. Old key is revoked."
}

Reputation & Rating

Every API listed on the Onchor marketplace has a reputation score between 0 and 100. The score is computed automatically from real usage data logged through the gateway — no manual reviews, no self-reported metrics.

Metrics tracked for each API:

Reputation builds over time as agents and developers consume APIs through the gateway. New listings start at 50 and adjust as real traffic flows through.

All API Reputations

curl https://api.onchor.xyz/api/public/reputation

# Response
{
  "apis": [
    {
      "listing_id": "lst_abc123",
      "slug": "solana-token-scanner",
      "name": "Solana Token Scanner",
      "reputation_score": 87,
      "uptime_pct": 99.4,
      "success_rate_pct": 98.1,
      "avg_latency_ms": 320,
      "unique_consumers": 42,
      "trend": "improving"
    },
    {
      "listing_id": "lst_def456",
      "slug": "nft-metadata-api",
      "name": "NFT Metadata API",
      "reputation_score": 72,
      "uptime_pct": 97.8,
      "success_rate_pct": 95.5,
      "avg_latency_ms": 580,
      "unique_consumers": 18,
      "trend": "stable"
    }
  ],
  "updated_at": "2026-03-15T08:00:00Z"
}

Seller Profile with Reputation

curl https://api.onchor.xyz/api/public/profile/merchant_uuid

# Response
{
  "merchant_id": "merchant_uuid",
  "display_name": "Onchor Labs",
  "total_apis": 3,
  "avg_reputation": 82,
  "apis": [
    {
      "listing_id": "lst_abc123",
      "slug": "solana-token-scanner",
      "reputation_score": 87,
      "uptime_pct": 99.4,
      "success_rate_pct": 98.1,
      "avg_latency_ms": 320,
      "unique_consumers": 42,
      "trend": "improving"
    }
  ],
  "member_since": "2025-11-01T00:00:00Z"
}

Error Handling

All errors return JSON with a detail field.

{ "detail": "Listing not found" }

Rate Limiting

When rate limited, the API returns 429 Too Many Requests. Back off and retry.

Copy Trading

Onchor Copy Trading is a Hyperliquid-focused system that analyzes 32,000+ traders, scores them on 8 performance metrics, detects crowding, and uses a multi-source signal engine to filter entries. Currently tracking 23 wallets with automated paper trading.

The copy trading API is served at /ct-api/api and powers both theweb dashboard and theTelegram bot.

Signal Engine

Every potential trade is scored by 4 independent signal sources, each normalized to [-1, +1] with a confidence weight:

Strategy Parameters

Endpoints

Telegram Bot

The Telegram bot (@copytrading_onchor_bot) provides real-time alerts and portfolio management:

Trade alerts are sent automatically when tracked wallets open or close positions. Paper positions can be manually closed via inline buttons and have automatic SL/TP execution running 24/7.