HTTP API

https://exen.wraxyn.io/v1/quote?chainId=8453&mode=sell&…

One base URL for everyone: https://exen.wraxyn.io. What differs between callers is how much they may ask for, not what they can reach — every route works without credentials.

The key goes in the x-api-key header. It is always optional — every route answers without one. Sending one raises your rate budget, removes the anonymous fee, and unlocks the configuration held against it:

• A rate budget of your own, instead of sharing the anonymous per-IP one with everyone else on your network.
• Attribution. Your partner id is hashed into the on-chain tag of every settlement, so fills you routed are identifiable on-chain and reconcilable to your responses.
• A negotiated fee policy, which replaces the10 bps (0.10%) anonymous fee and overrides any fee in the request. For most integration keys that policy is no fee at all.
• Access to gated venues. A few venues price only for allowlisted parties (tokenised real-world assets, for instance) and are invisible without an approved key.

Every request is admitted against a token bucket: a sustained rate plus a burst reservoir that refills continuously at that rate. Bursting is fine; sustaining above the rate is not — the reservoir is a one-time allowance, not extra throughput.

• Over-budget requests get 429 with a Retry-Afterheader (seconds, never zero). Honour it rather than retrying immediately — a tight retry loop spends the next second's budget too.
• X-RateLimit-Limit and X-RateLimit-Remaining come back on every response, not just refusals. Pace against those instead of discovering the ceiling by hitting it.
• Cache nothing that prices. A quote is a point in time; a cached one is not a cheaper quote, it is a wrong one.
• If you need a lot of quotes, timeLimitMs is the lever that matters more than the rate — see latency.

Solves the best route for a pair and size at the current block and returns exact integer amounts, the per-hop route breakdown, gas and USD values.

curl -s "https://exen.wraxyn.io/v1/quote\
?chainId=8453&mode=sell\
&sellToken=0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee\
&buyToken=0x833589fcd6edb6e08f4c7c32d4f71b54bda02913\
&sellAmount=1000000000000000000\
&slippagePct=0.5"

No key, no header, no account — that call works as written. See access for when you would want one.

Identical pricing and identical parameters, plus a required taker. It then firms up any market-maker legs with their makers and encodes the route into a transaction. The response is the quote body flattened at the top level plus the execution fields.

The budget is stamped when the request arrives, so queueing counts against it. Enforcement is best-effort: direct routes are always evaluated, and deeper search stops at the deadline.

• Fees are taken on the buy token, and buyAmount / minBuyAmount are returned net of them — you can show the returned number to your user as-is.
• Set your own with feeBps + feeRecipient (capped at 1500 bps = 15%). A request-supplied fee splits 85% to your recipient, 15% to the protocol.
• A fee policy negotiated against your API key overrides anything in the request.
• On a buy, the routing target is grossed up so your user still receives exactly what they asked for after the fee.

warnings[] is omitted when empty. Every code leaves the transaction executable — a warning means the response degraded on the way, never that the calldata is unusable. A request that cannot produce an executable route returns an error instead.

The body is { "error": "…" }. There are no stable machine codes on errors — branch on the status, never on the message text. (Success-path degradations do have stable codes: the warnings above.)

The venue labels routable on a chain — the exact strings route[].source reports and excludeVenues / includeVenues accept. It is the only place those strings are enumerated, so read them from here rather than hard-coding a list that grows without you.

curl -s "https://exen.wraxyn.io/v1/base/sources"

{ "chainId": 8453, "chain": "base",
  "sources": ["aerodrome-v1", "uniswap-v3", "uniswap-v4:doppler", …] }

{chain} is a path segment here, not the chainId query parameter quote and swap use: a name (ethereum, base, arbitrum, bsc, avalanche, xlayer, polygon, robinhood), a common alias (eth, bnb, avax) or the numeric id.

200 while the API is serving. 503 with status: degradedwhen a chain's view of the network has fallen behind — the same condition that makes quote and swap answer 503 for that chain. Use it for a status page or an uptime check.

curl -s "https://exen.wraxyn.io/healthz"

{ "status": "ok",
  "chains": [ { "chain": "base", "healthy": true }, … ] }

Treat status, and each chain's chain and healthy, as the contract. It is a liveness signal, not a coverage report — do not build on anything else you find in the body.

Everything on this page also exists as files you can hand to a tool, and as a rendered spec page if you would rather browse it than download it. All are generated from the same specification as the API itself, so they cannot describe a parameter we do not serve.

# generate a typed TypeScript client
npx openapi-typescript https://app.wraxyn.io/openapi.yaml -o exen-api.d.ts

# hand the whole API to an agent in one fetch
curl -s https://app.wraxyn.io/api.md

# 1. Build the transaction (native sell ⇒ no approval needed)
curl -s "https://exen.wraxyn.io/v1/swap\
?chainId=1&mode=sell\
&sellToken=0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee\
&buyToken=0xdac17f958d2ee523a2206206994597c13d831ec7\
&sellAmount=1000000000000000000\
&taker=$TAKER&slippagePct=0.3&timeLimitMs=299" \
  | jq '{buyAmount, minBuyAmount, gasUsd,
         to: .transaction.to, value: .transaction.value,
         route: [.route[] | {source, bps, amountIn, amountOut}]}'

# 2. eth_estimateGas against .transaction  — the final validity check
# 3. Sign and send it from $TAKER

# ERC-20 sell instead? One extra step first:
#   approve(<allowanceTarget from the response>, <sellAmount>)  from $TAKER

timeLimitMs=299 above is the latency-critical profile: on-chain venues only, deterministic. Drop it (or raise it past 300) to let market makers compete for the fill.

Note there is no key in that call — none is needed at the anonymous rate, so the quote it returns is net of the 10 bps (0.10%) anonymous fee. Add -H "x-api-key: $EXEN_KEY" once you have one and the same call prices on your own terms; the URL does not change.