Junction - Agent-mode overview

Machine-readable summary for AI agents. For the human view, visithttps://junction.exchange.

Product

Junction is a cross-chain DeFi exchange platform. It aggregates liquidity from 1inch, LiFi, Morpho, Hyperliquid, and native bridges behind a single REST/GraphQL API and MCP server. Capabilities:

swap - same-chain and cross-chain token swaps with smart routing.
bridge - one-call cross-chain transfers.
perps - Hyperliquid perpetual futures (USDC margin) and HL spot.
earn - Morpho vaults and validator staking.
onramp - fiat-to-crypto via MoonPay.

Endpoints

Purpose	URL
REST API (production)	`https://api.junction.exchange`
REST API (sandbox)	`https://sandbox.api.junction.exchange`
GraphQL gateway	`https://gateway.junction.exchange/graphql`
MCP server (Streamable HTTP)	`https://api.junction.exchange/mcp`
OpenAPI spec (JSON)	https://junction.exchange/openapi.json
OpenAPI spec (YAML)	https://junction.exchange/api/openapi.yaml
Human docs	https://docs.junction.exchange

Authentication

API key: Authorization: Bearer jxn_live_...
OAuth 2.0 authorization server metadata:/.well-known/oauth-authorization-server
OAuth 2.0 protected resource metadata (RFC 9728):/.well-known/oauth-protected-resource
Scopes: swap:read, swap:write, bridge:read,bridge:write, perps:read, perps:write,earn:read, earn:write, webhooks:manage,analytics:read.
Web Bot Auth (RFC 9421) directory:/.well-known/http-message-signatures-directory

Rate limits

Every response exposes these headers:

X-RateLimit-Limit
X-RateLimit-Remaining
X-RateLimit-Reset
Retry-After (on HTTP 429)

Free tier: 10 req/s, 100k req/day. Growth: 100 req/s. Scale: custom.

Errors

All errors return JSON with a stable error code and remediation link:

{
  "error": {
    "code": "INSUFFICIENT_LIQUIDITY",
    "message": "No route found within slippage budget",
    "httpStatus": 422,
    "docs": "https://docs.junction.exchange/errors#insufficient_liquidity",
    "retriable": false,
    "fields": ["amount", "slippageBps"]
  },
  "requestId": "req_01HX..."
}

Discovery files

/llms.txt - agent-readable site index
/llms-full.txt - full agent context
/index.md - markdown mirror of the homepage
/pricing.md - machine-readable pricing
/sitemap.xml
/.well-known/ai-plugin.json
/.well-known/agent.json
/.well-known/agent-card.json
/.well-known/mcp/server-card.json
/.well-known/api-catalog

Pricing

Tier	Price	Commission	Rate limit
Starter	Free	0.30%	10 req/s, 100k req/day
Growth	Volume-based	0.15%-0.25%	100 req/s
Scale	Custom	Custom	Custom

Full machine-readable pricing at /pricing.md or human view at/pricing.

Contact

General: [email protected]
Security: [email protected]
Support form: /contact