ArkAPI.dev Fund
How it works APIs Dashboard Fund AI Chat Early Access Contact Docs Fund →
Documentation • Live on Bitcoin mainnet

Get started with ArkAPI.

No accounts, no provider keys to manage. Fund a session with Bitcoin and start making calls, or use the OpenAI-compatible Bitcoin AI inference API. Agents can load the public ArkAPI SKILL.md for the complete safe workflow.

Official CLI and MCP server

The official ArkAPI client discovers the live catalog, turns OpenAPI schemas into typed MCP tools, supports Bearer and Ark-402 authentication, and enforces local daily spend limits.

arkapi catalog arkapi call btc-price --query currency=USD arkapi mcp serve

Download the client and view the secure agent setup →

Quick Start

1

Create a session:

curl -X POST https://arkapi.dev/v1/sessions \ -H 'Content-Type: application/json' \ -d '{"amount_sats":500}'

Returns a session token (ak_...) and a Lightning/Ark invoice.

2

Pay the invoice with any Lightning or Ark wallet. The session activates automatically once payment is confirmed.

3

Make API calls with your token:

curl -X POST https://arkapi.dev/api/dns-lookup \ -H "Authorization: Bearer ak_your_token" \ -d '{"domain":"example.com"}'

Authentication

Protected API calls accept a funded Bearer token or Ark-402 signed credit in the Authorization header. The post-quantum TLS checker is also available without an account for 10 successful calls per identity each UTC day. GET /api/my-ip is always free and public.

Check your balance

curl https://arkapi.dev/v1/balance \ -H "Authorization: Bearer ak_your_token"

Available Endpoints

Showing all endpoints.
No endpoints matched that search. Try bitcoin, translate, cve, or 1 sat.
EndpointCostDescription
/api/dns-lookup5 satsFull DNS records as structured JSON
/api/whois5 satsWHOIS data parsed into clean JSON
/api/ssl-check5 satsSSL certificate analysis
/api/post-quantum-check10 included/day, then 5 satsRFC 10024 X25519MLKEM768 readiness report with A–F grade, transparent score, verified HTTPS, TLS 1.3, X25519 compatibility checks, and a one-hour result cache
/api/headers5 satsHTTP security headers audit with score
/api/weather5 satsCurrent weather + 7-day forecast
/api/my-ipFreeAccountless GET endpoint returning the caller's observed IPv4 or IPv6 address as JSON, or plain text with ?format=text
/api/ip-lookup5 satsIP geolocation, ISP, ASN, approximate location, and Google Maps link
/api/ip-abuse-check5 satsAbuseIPDB reputation lookup with abuse confidence, report counts, and last reported time
/api/ip-intel5 satsCombined IP geolocation, ASN, abuse-desk RDAP contact when published, map link, AbuseIPDB reputation, and URLhaus host summary in one response
/api/email-auth-check5 satsSPF, DKIM, and DMARC posture check with an A-F grade
/api/axfr-check5 satsCheck whether a domain allows DNS zone transfer and return exposed AXFR records when available
/api/domain-intel5 satsAggregate DNS, WHOIS, TLS, headers, email auth, nameserver and mail host intel, parsed security.txt, parsed robots.txt, improved tech fingerprinting, http_behavior, CT-log subdomains, provider detection, and resolved IP intelligence, with optional ai_summary
/api/hash-crack5 satsRecover weak md5, sha1, sha256, or ntlm hashes using fasttrack mode only
/api/bitcoin-news5 satsLightweight GET endpoint for multi-source Bitcoin headlines with cross-feed dedupe and AI-assisted per-item sentiment; optional ?limit=5
/api/btc-whale-signal5 satsLightweight GET endpoint for BTC whale activity from public mempool.space on-chain data, including large-output counts, notable volume, latest block context, and top transactions
chat.arkapi.dev/v1/chat/completions3 included/day, then 5 satsOpenAI-compatible AI inference with Bearer or Ark-402 authorization, streaming, tool calls, SDK support, and native Tor access
/api/ai-chat5 satsAnonymous AI chat with prompt or messages input
/api/ai-translate5 satsHigher-quality AI translation with optional style control
/api/image-generate5 satsAI image generation
/api/screenshot5 satsFull-page website screenshot
/api/qr-generate5 satsQR code generation from a data string
/api/bitcoin-address5 satsBitcoin address validation + balance
/api/btc-price5 satsLightweight GET endpoint for live Bitcoin spot price and market stats; defaults to USD and accepts ?currency=USD or ?currencies=USD,EUR,CAD, plus an Alternative.me fear_greed snapshot
/api/cve-search5 satsSearch CVEs by keyword or product
/api/prediction-market-search5 satsSearch open Polymarket prediction markets and return normalized results
/api/remote-job-search5 satsLightweight GET endpoint for remote jobs from Remotive; accepts search, category, or company_name, with optional limit
/api/paste5 satsStore short-lived text or JSON and return a public scratchpad URL under /v1/p/{id}; accepts exactly one of content or json, plus optional ttl_seconds, burn_after_read, and max_views
/api/cve-lookup5 satsLook up a specific CVE by ID using cve
/api/translate5 satsText translation between languages
/api/domain-check5 satsDomain availability check
/api/url-to-markdown5 satsExtract clean Markdown from any public URL

Most endpoints accept POST with a JSON body unless the table says otherwise. See the live catalog for latest pricing.

Response Format

Paid API responses follow the same wrapper. The free /api/my-ip utility intentionally returns the compact shape {"ip":"…"} (or plain text) for command-line compatibility.

{ "success": true, "data": { ... }, "cost_sats": 5, "balance_remaining": 9995, "response_ms": 45, "endpoint": "/api/dns-lookup" }

On error, success is false and an error field describes the issue. Failed calls are not charged.

Featured Guide

Focused endpoint guides: Anonymous AI Chat API, AI Translate API, AXFR Check API, BTC Whale Signal API, CVE Search API, DNS Lookup API, Domain Intel API, Email Auth Check API, Headers Audit API, Hash Crack API, IP Abuse Check API, IP Intel API, Paste / Scratchpad API, Post-Quantum TLS Checker, Remote Job Search API, SSL Check API, URL to Markdown API, and WHOIS API.

Error Codes

FAQ

Is this on mainnet?
Yes. ArkAPI is live on Bitcoin mainnet and uses real sats.
Do I need an account?
No. Sessions are anonymous. Create a token, pay, and start making calls.
What happens when my balance runs out?
API calls return a 402 error. Create and fund a new session on the Fund page.
Can I get a refund?
Failed backend work is returned to the same API balance. Unused session and Ark-402 balances are not user-refundable.
What wallets work?
Use a mainnet Lightning wallet for Lightning invoices or a compatible Bark or Shhark wallet for Ark funding and Ark-402 signing.
Is there a rate limit?
Yes. The default limit is 60 requests per minute per session. Expensive endpoints have tighter controls. The post-quantum checker allows 30 calls per hour per identity, including 10 successful no-account checks per UTC day.
Can I publish my own API?
The Early Access program is currently the path for API publishers. Visit the page to request access and follow development.
How do I get Bitcoin sats?
Fund ArkAPI from a compatible mainnet Lightning, Bark, or Shhark wallet. Mainnet payments use real Bitcoin.
Where can I read more about Ark?
Read the official Ark protocol docs at ark-protocol.org/intro/.