Examples
Free snapshot — zero setup
Read live market state with one command. No key, no wallet, no payment.
The market snapshot is the open-data carve-out: free, unauthenticated, honest freshness. Start here to verify connectivity before paying for anything.
curl
curl https://api.tollbridge.app/v1/market/BTCExpect { "data": { "asset": "BTC", "venue", "quote", "derived", "provenance" }, "meta": … }.
TypeScript
import { Tollbridge } from '@tollbridge/sdk-typescript';
const toll = new Tollbridge({ baseUrl: 'https://api.tollbridge.app' });
const market = await toll.market('BTC');
console.log(market.data.derived.mid, market.data.derived.spread_bps);
console.log(market.meta.freshness); // honesty block — read itPython
import httpx
# Reference snippet — official Python SDK in progress.
r = httpx.get("https://api.tollbridge.app/v1/market/BTC")
data = r.json()["data"]
print(data["venue"], data["derived"]["mid"])MCP
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "tollbridge_market_state",
"arguments": { "asset": "BTC" }
}
}What to check in the response
meta.freshness[]— is the snapshot within its staleness budget (ok: true)?data.provenance— source, provider, age. If quality is degraded, the data says so.
Next: pay for an actual deep decision.