circuit llm // developer reference
API ENDPOINTS
120+ endpoints for Solana data, DEX prices, token analysis, market intelligence, DeFi, and autonomous swarm signals. Pricing endpoints are free and public — just call and get data, no payment required. A full free Triton gRPC price feed is also available at 60 req/min. Everything else uses x402 micropayments in CIRC. No API keys, no accounts.
◈ 120+ endpoints
⚡ gRPC-powered, sub-second
◈ Pricing free & public
⚡ x402 CIRC for paid data
◈ Price Feed free at 60/min
// Solana mainnet-beta
// 240 req/min pricing limit
Base URL
https://api.circuitllm.xyz
Network
Solana mainnet-beta
CIRC Mint (Token-2022)
8fQgfsRnRkKSeNUhevT7wp8mhNvMSJdLn1fJi4oVpump
COPY
Treasury (payment recipient)
loading…
COPY
x402 PAYMENT PROTOCOL
HOW IT WORKS
Circuit uses the x402 standard — HTTP 402 Payment Required — for API monetization. Instead of API keys, you pay per call with CIRC tokens on Solana. The server verifies the on-chain transaction, confirms the correct amount was sent to treasury, and returns your data. Each signature is single-use and expires 5 minutes from the transaction timestamp.
01
QUOTE
GET /api/quote for current CIRC/USD rate and exact cost per endpoint
02
SEND CIRC
Transfer the required CIRC amount to the treasury wallet using Token-2022
03
ATTACH SIG
Resend your request with header X-Payment-Signature: <txSignature>
04
GET DATA
Server verifies on-chain, marks sig used to prevent replay, returns 200 + data
STEP 1 — get current quote
# Always fetch fresh — CIRC price changes curl https://api.circuitllm.xyz/api/quote
{
"payment": {
"treasury": "<treasury_wallet>",
"circUsdPrice": 0.000041
},
"endpoints": {
"market": {
"usdPrice": 0.002,
"circRequired": "48.78 CIRC"
}
}
}
STEP 2–4 — pay and fetch
# Send CIRC using your Token-2022 wallet # Then call the endpoint with the tx sig curl https://api.circuitllm.xyz/api/market \ -H "X-Payment-Signature: 5Kg3..."
# On failure, you get guidance: { "error": "Payment Required", "payment": { "amountDisplay": "48.78 CIRC", "recipient": "<treasury>" } }
BYPASS: Requests from 127.0.0.1/::1 (localhost) skip payment entirely — all deployed agents call freely.
Server-to-server integrations can use the X-Internal-Key header with a shared secret.
Each tx signature is single-use and expires 5 minutes from block timestamp.
no endpoints match your search