--- name: keepbal description: One key and one prepaid wallet for agent tools and models. --- # KeepBal One key and one prepaid wallet. 7 models and 2543 catalog tools are live. Create an account at https://keepbal.com/sign-up, then create an API key in Console → API keys. Send Authorization: Bearer $KEEPBAL_API_KEY to KeepBal only. ## MCP Connect to https://keepbal.com/mcp using Streamable HTTP and Authorization: Bearer $KEEPBAL_API_KEY. The four meta-tools are search_tools, inspect_tool, run_tool and get_run. Search and inspection are free. get_run checks and settles an existing run without a new execution or polling fee. Setup: https://keepbal.com/docs/mcp. ## Browse tools - [Tools](https://keepbal.com/tools) - [Providers](https://keepbal.com/providers) - [Models](https://keepbal.com/models) - [MCP](https://keepbal.com/mcp) ## Categories - [company-and-people-data](https://keepbal.com/tools/category/company-and-people-data) - [seo-and-marketing](https://keepbal.com/tools/category/seo-and-marketing) - [finance-and-markets](https://keepbal.com/tools/category/finance-and-markets) - [crypto-and-defi](https://keepbal.com/tools/category/crypto-and-defi) - [travel-and-local](https://keepbal.com/tools/category/travel-and-local) - [prediction-markets](https://keepbal.com/tools/category/prediction-markets) - [media-generation](https://keepbal.com/tools/category/media-generation) - [web-scraping](https://keepbal.com/tools/category/web-scraping) - [social-media](https://keepbal.com/tools/category/social-media) - [search-and-extraction](https://keepbal.com/tools/category/search-and-extraction) - [china-social](https://keepbal.com/tools/category/china-social) - [jobs-and-careers](https://keepbal.com/tools/category/jobs-and-careers) - [developer-tools](https://keepbal.com/tools/category/developer-tools) - [other](https://keepbal.com/tools/category/other) - [email-and-messaging](https://keepbal.com/tools/category/email-and-messaging) ## Providers - [Hunter](https://keepbal.com/providers/hunterio) - [ContactOut](https://keepbal.com/providers/contactout) - [ElevenLabs](https://keepbal.com/providers/elevenlabs) - [Y Combinator](https://keepbal.com/providers/ycombinator) - [Levels.fyi](https://keepbal.com/providers/levels-fyi) - [Yahoo Finance](https://keepbal.com/providers/yahoo-finance) - [Google Trends](https://keepbal.com/providers/google-trends) - [Weather Underground](https://keepbal.com/providers/weather-underground) - [StockAnalysis](https://keepbal.com/providers/stockanalysis) - [MarketBeat](https://keepbal.com/providers/marketbeat) - [Crunchbase](https://keepbal.com/providers/crunchbase) - [Zillow](https://keepbal.com/providers/zillow) - [Wellfound](https://keepbal.com/providers/wellfound) - [Indeed](https://keepbal.com/providers/indeed) - [IQAir](https://keepbal.com/providers/iqair) - [Edmunds](https://keepbal.com/providers/edmunds) - [Finviz](https://keepbal.com/providers/finviz) - [Kelley Blue Book](https://keepbal.com/providers/kbb) - [G2](https://keepbal.com/providers/g2) - [OpenAI](https://keepbal.com/providers/openai) - [Gemini](https://keepbal.com/providers/gemini) - [MiniMax](https://keepbal.com/providers/minimax) - [Kling](https://keepbal.com/providers/kling) - [Alibaba](https://keepbal.com/providers/alibaba) - [ByteDance](https://keepbal.com/providers/bytedance) - [People Data Labs](https://keepbal.com/providers/pdl) - [Clay](https://keepbal.com/providers/clay) - [AAA Gas Prices](https://keepbal.com/providers/aaa-gas-prices) - [SEC Form 4](https://keepbal.com/providers/secform4) - [GetApp](https://keepbal.com/providers/getapp) - [LoopNet](https://keepbal.com/providers/loopnet) - [Homes.com](https://keepbal.com/providers/homes) - [Cars.com](https://keepbal.com/providers/cars) - [Built In](https://keepbal.com/providers/builtin) - [Idealist](https://keepbal.com/providers/idealist) - [Web3 Career](https://keepbal.com/providers/web3-career) - [Artificial Analysis](https://keepbal.com/providers/artificial-analysis) - [Bid.cars](https://keepbal.com/providers/bid-cars) - [Topaz Labs](https://keepbal.com/providers/topaz) - [DataForSEO](https://keepbal.com/providers/dataforseo) - [Open-Meteo](https://keepbal.com/providers/openmeteo) - [Firecrawl](https://keepbal.com/providers/firecrawl) - [Ahrefs](https://keepbal.com/providers/ahrefs) - [Apollo](https://keepbal.com/providers/apollo) - [DefiLlama](https://keepbal.com/providers/defillama) - [Polymarket](https://keepbal.com/providers/polymarket) - [FRED](https://keepbal.com/providers/fred) - [CoinGecko](https://keepbal.com/providers/coingecko) - [Browserbase](https://keepbal.com/providers/browserbase) - [AccuWeather](https://keepbal.com/providers/accuweather) - [Nasdaq](https://keepbal.com/providers/nasdaq) - [Trustpilot](https://keepbal.com/providers/trustpilot) ## Catalog access Catalog tool results use {status, run_id?, output?}. For a pending run, poll GET /apis/v1/runs/. GET https://keepbal.com/catalog.json?page=1 lists live tools, 200 per page. Read total, page, next_page and each tool's pricing. Follow next_page until null. Models and the catalog summary are included on each page. Prices are in micro-USD: 1 USD = 1,000,000 micro-USD. Fixed tools show price_micros per successful call. Variable tools show their customer price in pricing.description, normally "Variable: provider price plus 35%". Check each tool before calling. ## Call a catalog tool POST /apis/v1/run with {"publicId":"","input":{"body":{},"queryParams":{},"pathParams":{}}} and your API key. Inspect lists required catalog keys in pathParams.required; supply their values in input.pathParams. Variable tools use request quantities when provided. If a unit quantity is unknown, pass max_cost_usd in the top-level request or X-KeepBal-Max-Cost-USD header. This is your maximum customer charge, requires enough balance to cover it, and persists through asynchronous completion; a provider cost above it fails with no charge. Page/result estimates default to at least 100 when no documented quantity is known. ```sh curl https://keepbal.com/apis/v1/exa/contents \ -H "Authorization: Bearer $KEEPBAL_API_KEY" \ -H "Content-Type: application/json" \ --data '{"urls":["https://example.com"]}' ``` For a pending result, GET /apis/v1/runs/:id. A successful run is charged once; checking it adds no polling fee. Failed, blocked, or timed-out runs cost $0. ## Live models Prices below list applicable rates in USD per 1M tokens. GET /v1/models lists callable models. Set model to the public ID below; send the request format for its endpoint. - claude-haiku-4.5: Input: $1.25 / Output: $6.25 / Cache read: $0.13 / Cache write: $2.5 per 1M tokens; POST /v1/messages. [Model guide](https://keepbal.com/models/claude-haiku-4.5) - claude-sonnet-4.5: Input: $3.75 / Output: $18.75 / Cache read: $0.38 / Cache write: $7.5 per 1M tokens; POST /v1/messages. [Model guide](https://keepbal.com/models/claude-sonnet-4.5) - deepseek-v3.2: Input: $0.336 / Output: $0.504 / Cache read: $0.26 / Cache write: $0 per 1M tokens; POST /v1/chat/completions. [Model guide](https://keepbal.com/models/deepseek-v3.2) - gpt-5.4: Input: $3.13 / Output: $18.75 / Cache read: $0.32 / Cache write: $0 per 1M tokens; POST /v1/chat/completions. [Model guide](https://keepbal.com/models/gpt-5.4) - gpt-5.4-mini: Input: $0.94 / Output: $5.63 / Cache read: $0.1 / Cache write: $0 per 1M tokens; POST /v1/chat/completions. [Model guide](https://keepbal.com/models/gpt-5.4-mini) - jina-embeddings-v3: Input: $0.07 per 1M tokens; POST /v1/embeddings. [Model guide](https://keepbal.com/models/jina-embeddings-v3) - qwen3-max: Input: $1.44 / Output: $7.2 / Cache read: $0.9 / Cache write: $0 per 1M tokens; POST /v1/chat/completions. [Model guide](https://keepbal.com/models/qwen3-max) Messages models use Anthropic Messages format, with max_tokens and messages. Embeddings use input and have no output tokens. Chat Completions models use messages. Responses is available only when the model's route supports it. ## Find other tools POST /apis/v1/discover with {"query":"web search"}; POST /apis/v1/inspect with publicId returned by discovery. Both operations are free. POST /apis/v1/run with publicId and input: {body?, queryParams?, pathParams?} as described by inspect. Fixed tools show the per-call price; variable tools bill provider price plus 35%. Inspect returns pricing metadata, not a quote. Catalog tool spend caps: REST top-level max_cost_usd, MCP input.max_cost_usd, or the X-KeepBal-Max-Cost-USD header. Caps must cover the estimate and fit your available balance; they persist through async completion. Costs above the cap fail without charge. Some variable tools require a cap or quantity. Fixed tools charge the published per-call price. Variable tools charge the provider's reported actual cost plus the disclosed markup (currently 35%). Missing actual cost on variable tools charges $0. Quotes are estimates, labelled estimated_price; completed price is the settlement debit. Failed, blocked, or timed-out runs cost $0. ## Wallet GET /v1/credits/balance and GET /v1/usage are free. Signup includes $1 free credit, once. Top up $10, $20, $50, or $100 in Console → Wallet. No subscription. Top-up fee: 8% rounded up to the cent + $0.35 before tax; only credit reaches the wallet. Requests must pass a balance check before forwarding. Charges settle after calls. Unavailable routes return 503 provider_unavailable and are not billed. ## Sitemaps - https://keepbal.com/sitemap.xml - https://keepbal.com/sitemap-tools.xml - https://keepbal.com/sitemap-categories.xml ## Request details Only live catalog items can be called. Unknown model IDs return 404 model_not_found. Use POST /v1/messages for Messages models; Chat Completions rejects those models. Input and output usage determine token charges, including cached input reported by Messages. Streaming usage is recorded when the stream completes. For tools with query inputs, flat scalar values are supported. Nested query values are rejected. Templated path values must occupy one path segment. 402 insufficient_credits means the balance cannot cover the estimated request. Concurrent requests can exceed the preflight balance check; it is not a hard spending cap. Read x-keepbal-request-id and x-keepbal-cost-micros when present. Streaming responses have no final charge header; read Usage after the call is recorded. KeepBal errors use the OpenAI error format. Upstream error bodies may differ. MCP is live at https://keepbal.com/mcp (Streamable HTTP, bearer key). Setup: https://keepbal.com/docs/mcp. A2A transport is not live. ## Markdown pages Tools, categories, providers, models, docs, integration guides and comparison pages have .md twins. Append .md before the query (for example /tools.md?page=2), or send Accept: text/markdown to the HTML URL. Pagination links traverse the same catalog. HTML advertises a text/markdown alternate; Markdown returns a canonical Link header. ## References - Pricing: https://keepbal.com/pricing - Catalog: https://keepbal.com/catalog.json?page=1 - Skill: https://keepbal.com/SKILL.md - OpenAPI: https://keepbal.com/openapi.yaml - Docs: https://keepbal.com/docs - Full reference: https://keepbal.com/llms-full.txt