canonical: https://jentic.com/apis/griffnode.com/griffnode # GriffNode API The GriffNode API accepts cryptocurrency payments including Bitcoin, Litecoin, Dogecoin, Dash, Ethereum, and ERC-20 tokens through a server-to-server integration authenticated with a secret API key. Merchants create payment transactions or itemized detailed transactions, list and retrieve them, and read current crypto and fiat exchange rates. It also exposes supported cryptocurrencies, the merchant's configured wallets, plan and usage, on-platform balances, and transaction analytics. ## For AI agents Lets an AI agent create cryptocurrency payment transactions, list and retrieve them, and read exchange rates and merchant analytics. ## Scope Does not handle fiat card processing, crypto custody, or on-chain settlement. Use for accepting cryptocurrency payments only. ## Capabilities - Accept Bitcoin, Litecoin, Dogecoin, Dash, Ethereum, and ERC-20 token payments - Create a payment transaction or an itemized detailed transaction - Retrieve and list the merchant's transactions - Read current crypto and fiat exchange rates - List supported cryptocurrencies and the merchant's configured wallets - Read merchant plan, usage, balances, and transaction analytics ## Use cases ### Agent-run crypto checkout An AI agent can accept cryptocurrency for an order through GriffNode by creating a payment transaction, returning the payment details to the buyer, and retrieving the transaction to confirm it. Live and test modes share one base URL, switched by the secret-key prefix, so an agent can rehearse the flow safely. Connected through Jentic, the agent calls only the transaction operations it needs. Example prompt: Create a payment transaction for an order amount, return the payment details, and retrieve the transaction to confirm its status ### Rate-aware pricing Merchants quoting prices in crypto need current rates. GriffNode returns current crypto and fiat exchange rates denominated in USD, and lists every supported cryptocurrency and token. An agent can price an order in a chosen coin before creating the transaction. Example prompt: Read the current USD rate for a cryptocurrency and use it to quote an order amount ### Merchant reporting Finance teams reconcile crypto payments and monitor usage against plan limits. GriffNode exposes transaction analytics, on-platform balances for overage and top-up, and plan and usage details. An agent can pull these to build a reconciliation or alerting workflow. Example prompt: Retrieve the merchant's transaction analytics and current plan usage for a reconciliation report ## Key endpoints | Method | Path | Description | | --- | --- | --- | | POST | `/transactions/create` | Create a payment transaction | | POST | `/transactions/create-detailed` | Create an itemized transaction | | GET | `/transactions/list` | List the merchant's transactions | | GET | `/transactions/{transaction_id}` | Retrieve a single transaction | | GET | `/prices` | Current crypto and fiat exchange rates | | GET | `/cryptos/list` | List supported cryptocurrencies and tokens | | GET | `/stats` | Merchant transaction analytics | ## Key resources - **Transactions** — Create, list, and retrieve crypto payment transactions - **Rates** — Current crypto and fiat exchange rates in USD - **Cryptocurrencies** — Supported coins and tokens and the merchant's configured wallets - **Account** — Merchant plan, usage, and on-platform balances - **Analytics** — Merchant transaction analytics ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 65 / 100 - **Maturity:** AI-Aware - **Dimensions:** - Foundational Compliance: 100 / 100 - Developer Experience & Jentic Compatibility: 63 / 100 - AI-Readiness & Agent Experience: 46 / 100 - Agent Usability: 94 / 100 - Security: 60 / 100 - AI Discoverability: 63 / 100 - **View full report:** https://jentic.com/apis/griffnode.com/griffnode/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring GriffNode by hand means managing its live and test secret keys, the two-window rate limits, and the string-versus-number amount formats between responses and webhooks yourself. Through Jentic you install once, import GriffNode from the API Directory, store the secret key once, and your agent calls it. - **Permission scoping:** GriffNode carries the amount, coin, and transaction id in the path and body, so a rule bounds which operations your agent may call rather than which transaction. You choose the operations it may call, so the billing-checkout operation is not included unless you add it. - **Credential handling:** Your GriffNode secret key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'create a crypto payment' or 'read exchange rates', and Jentic returns the matching GriffNode operation with its input schema so the agent calls the right endpoint without reading the reference docs. ## Related APIs - **NOWPayments API** — Another cryptocurrency payment gateway versus GriffNode's multi-coin acceptance. - **ECOMMPAY API** — Fiat card and alternative-method processing versus GriffNode's crypto-only flow. - **Coinbase Advanced Trade** — An exchange to convert or hold the crypto GriffNode collects. ## FAQ ### What authentication does the GriffNode API use? GriffNode authenticates with a secret API key sent as a Bearer token in the Authorization header, per its OpenAPI spec, using a live or test key prefix on the same base URL. The health check and hosted-checkout redirect are public. Through Jentic the secret key is stored encrypted by your own Jentic One instance and injected at execution time. ### Can I accept Bitcoin and Ethereum payments with the GriffNode API? Yes. The transaction operations create a payment in Bitcoin, Litecoin, Dogecoin, Dash, Ethereum, or an ERC-20 token, and you can retrieve or list transactions afterward. The rates operation returns current USD-denominated prices so an order can be quoted in the chosen coin. ### What are the rate limits for the GriffNode API? GriffNode rate-limits each API key in two windows, per minute and per hour, by plan tier, and the OpenAPI spec notes the two windows. Check https://docs.griffnode.com for the per-plan figures. ### How do I create a crypto payment with the GriffNode API through Jentic? Search Jentic for 'create a crypto payment' and it returns the GriffNode create-transaction operation with its input schema, so your agent fills the amount and coin and calls it. Install Jentic One with `curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh`, import GriffNode from the API Directory, and store your secret key once. To run it on your own infrastructure, install Jentic One from its GitHub repo. ### Can I limit what my agent is allowed to do with GriffNode? Yes. Write a rule that allows only the create-transaction and transaction read operations, so the agent can take payments and check their status but cannot start a billing checkout or plan upgrade, and every call it makes is logged. ### Is there a GriffNode MCP server? You don't need an MCP server to connect your agent to GriffNode. Jentic connects it directly from the API Directory: import it, store your credential once, and your agent discovers and calls the operations it needs on demand.