GriffNode API
API by GriffNode · rest
Accept Bitcoin, Litecoin, Dogecoin, Dash, Ethereum and ERC-20 tokens. Server-to-server, authenticated with a secret API key (Authorization: Bearer sk_live_… for live, or sk_test_… for test mode — same base URL). All monetary amounts in API responses are JSON numbers; webhook amounts are strings to preserve decimal precision (see the webhooks section). Rate limits. Every request is rate-limited per API key in two windows — per minute and per hour — by plan tier (min/hour): starter 30/500, business 100/2000, professional 300/5000, enterprise 1000/20000. Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset (Unix seconds) for the per-minute window. On 429 the body is error: "RATE_LIMIT_EXCEEDED" (either window) with a Retry-After header (seconds) — clients should retry after it. A separate 429 with error: "MONTHLY_LIMIT_REACHED" means the plan's monthly transaction quota (not the request rate).
Endpoint: https://api.griffnode.com/v1
Verification: observed. Source: crawl.
Capabilities (16)
- Merchant plan usage and limits
- Deprecated: always an empty list. GriffNode keeps no on-platform balance (no…
- Start a plan upgrade
- All supported cryptocurrencies and tokens
- API health check
- GriffNode billing invoices (platform ↔ merchant)
- Cryptocurrencies this merchant has wallets configured for
- Hosted-checkout redirect (browser flow publishable key)
- Plan catalogue and pricing
- Current crypto and fiat exchange rates (USD-denominated)
- Merchant transaction analytics
- Create a payment transaction
- Create an itemized transaction (Professional/Enterprise plans)
- List the merchant's transactions (newest first)
- Retrieve a single transaction
- Simulate a test payment outcome