# GriffNode API API

**Canonical:** https://apis.io/apis/griffnode-com/griffnode-api-api/  
**Provider:** GriffNode — https://apis.io/providers/griffnode-com/  
**Base URL:** https://api.griffnode.com/v1  
**Documentation:** https://docs.griffnode.com/reference

GriffNode API API is one of 2 APIs that [GriffNode](https://apis.io/providers/griffnode-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

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 stri

## Operations (16)

| Method | Path | Summary |
|---|---|---|
| GET | `/health` | API health check |
| GET | `/pay` | Hosted-checkout redirect (browser flow, publishable key) |
| POST | `/transactions/create` | Create a payment transaction |
| POST | `/transactions/create-detailed` | Create an itemized transaction (Professional/Enterprise plans) |
| GET | `/transactions/list` | List the merchant's transactions (newest first) |
| GET | `/transactions/{transaction_id}` | Retrieve a single transaction |
| GET | `/prices` | Current crypto and fiat exchange rates (USD-denominated) |
| GET | `/cryptos/list` | All supported cryptocurrencies and tokens |
| GET | `/merchant/cryptos` | Cryptocurrencies this merchant has wallets configured for |
| GET | `/account` | Merchant plan, usage and limits |
| GET | `/plans` | Plan catalogue and pricing |
| GET | `/balances` | Deprecated: always an empty list. GriffNode keeps no on-platform balance (no overage, no top-ups); crypto settles straight to your wallet. |
| GET | `/stats` | Merchant transaction analytics |
| GET | `/invoices` | GriffNode billing invoices (platform ↔ merchant) |
| POST | `/transactions/{transaction_id}/simulate` | Simulate a test payment outcome |
| POST | `/billing/checkout` | Start a plan upgrade |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/griffnode-com/openapi/_original/griffnode-com-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/griffnode-com/json-schema/griffnode-com-transaction-schema.json
- **JSONSchema** — https://artifacts.apis.io/griffnode-com/json-schema/griffnode-com-account-schema.json
- **JSONSchema** — https://artifacts.apis.io/griffnode-com/json-schema/griffnode-com-plan-schema.json
- **JSONSchema** — https://artifacts.apis.io/griffnode-com/json-schema/griffnode-com-create-detailed-transaction-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/griffnode-com/json-schema/griffnode-com-invoice-schema.json
- **JSONSchema** — https://artifacts.apis.io/griffnode-com/json-schema/griffnode-com-create-transaction-request-schema.json

## Other GriffNode APIs (1)

- [GriffNode API](https://apis.io/apis/griffnode-com/griffnode-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/griffnode-com/griffnode-api-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/griffnode-com/.