How it works APIs Dashboard Fund Early Access Contact Docs Fund →
Documentation • Live on Signet test network only

Get started with ArkAPI.

No accounts, no API keys to manage. Fund a session with Bitcoin and start making calls.

Quick Start

1

Create a session:

curl -X POST https://arkapi.dev/v1/sessions

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

Every API call requires a Bearer token in the Authorization header. Tokens start with ak_ and are returned when you create a session.

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-lookup3 satsFull DNS records as structured JSON
/api/whois5 satsWHOIS data parsed into clean JSON
/api/ssl-check5 satsSSL certificate analysis
/api/headers3 satsHTTP security headers audit with score
/api/weather3 satsCurrent weather + 7-day forecast
/api/ip-lookup3 satsIP geolocation, ISP, ASN, approximate location, and Google Maps link
/api/ip-abuse-check4 satsAbuseIPDB reputation lookup with abuse confidence, report counts, and last reported time
/api/ip-intel6 satsCombined IP geolocation, ASN, abuse-desk RDAP contact when published, map link, AbuseIPDB reputation, and URLhaus host summary in one response
/api/email-auth-check4 satsSPF, DKIM, and DMARC posture check with an A-F grade
/api/axfr-check12 satsCheck whether a domain allows DNS zone transfer and return exposed AXFR records when available
/api/domain-intel25 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-crack25 satsRecover weak md5, sha1, sha256, or ntlm hashes using fasttrack mode only
/api/bitcoin-news2 satsMulti-source Bitcoin headlines with cross-feed dedupe and AI-assisted per-item sentiment
/api/ai-chat100 satsAnonymous AI chat with prompt or messages input
/api/ai-translate25 satsHigher-quality AI translation with optional style control
/api/image-generate25 satsAI image generation
/api/screenshot15 satsFull-page website screenshot
/api/qr-generate2 satsQR code generation from a data string
/api/bitcoin-address3 satsBitcoin address validation + balance
/api/btc-price1 satLive Bitcoin spot price in 10 major fiat currencies, with optional currency or currencies query parameters, market stats, and an Alternative.me fear_greed snapshot
/api/cve-search4 satsSearch CVEs by keyword or product
/api/prediction-market-search4 satsSearch open Polymarket prediction markets and return normalized results
/api/remote-job-search3 satsSearch remote jobs from Remotive by keyword, category, or company with a cached agent-friendly response
/api/paste2 satsStore short-lived text or JSON and return a short public scratchpad URL with optional one-time or limited-view retrieval
/api/cve-lookup3 satsLook up a specific CVE by ID using cve
/api/translate3 satsText translation between languages
/api/domain-check3 satsDomain availability check
/api/url-to-markdown5 satsExtract clean Markdown from any public URL

Most endpoints accept POST with a JSON body. /api/bitcoin-news, /api/btc-price, and /api/remote-job-search are lightweight GET endpoints. /api/bitcoin-news accepts an optional ?limit=5 query parameter. /api/remote-job-search accepts search, category, or company_name, plus optional limit. /api/paste accepts exactly one of content or json, plus optional ttl_seconds, burn_after_read, and max_views, and returns a public read URL under /v1/p/{id}. If you do not pass a currency filter to /api/btc-price, the response defaults to USD. Optional price query params: ?currency=USD or ?currencies=USD,EUR,CAD. Field-name reminders: /api/ai-chat expects prompt or messages, /api/qr-generate expects data, /api/cve-lookup expects cve, and /api/hash-crack expects hash, type, and optional mode set to fasttrack. See the live catalog for latest pricing.

Response Format

Every API response follows the same wrapper:

{ "success": true, "data": { ... }, "cost_sats": 3, "balance_remaining": 9997, "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, 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, Remote Job Search API, SSL Check API, URL to Markdown API, and WHOIS API.

Error Codes

FAQ

Is this on mainnet?
ArkAPI is currently live on Signet test network only. Sats are test sats, not real Bitcoin.
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 API calls are automatically refunded to your session balance. On Signet, session balances are non-refundable — test sats are free from the faucet. Session balance refunds will be available when ArkAPI launches on mainnet.
What wallets work?
Any Lightning or Ark-compatible wallet. For testing on Signet, use bark or other Signet wallets.
Is there a rate limit?
Yes. The default limit is 60 requests per minute per session. Expensive endpoints have tighter per-token limits: image generation and screenshot are 5 per hour, and anonymous AI chat is 5 per 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 Signet test sats?
Visit the Ark Faucet, enter your Signet wallet address, and you'll receive free test sats. Use those to fund an ArkAPI session on the Fund page. Signet sats have no real value — they exist only for testing.
Where can I read more about Ark?
Read the official Ark protocol docs at ark-protocol.org/intro/.