Skip to main content
​
API

​
Get a single transaction

The new Get Transaction endpoint, GET /transaction/{tnxRef}, returns one transaction by its reference, so you no longer have to page through Get Transactions to check a single deposit, withdrawal, redemption, or bridge.Verify Withdrawal is now scoped to your business as well: a reference that belongs to another business returns Transaction not found.

​
New bridge.completed webhook

A new bridge.completed event fires when a bridge settles and the cNGN is minted on the destination network. Subscribe to it like any other event. Failed bridges fire transaction.failed with trx_type swap.The TypeScript library exposes this as getTransaction(tnxRef), and the AI agent skill (v1.1.0) documents the endpoint.
​
Tooling

​
AI agent skill

The cNGN API skill packages this documentation for coding agents. Install it into Claude Code with /plugin marketplace add wrappedcbdc/cNGN_api_skill, or point any agent that reads AGENTS.md at the repository.It covers the parts of the API that are easy to get wrong from REST conventions alone: the encrypted wire format in both directions, per-environment network IDs, and the retry rules for money-moving endpoints. The repository also ships an OpenAPI 3.1 description and scripts that encrypt a request body or decrypt a response payload locally, which is the quickest way to tell a key problem from an API problem.Source: wrappedcbdc/cNGN_api_skill.
​
Networks

​
Celo support

cNGN is now deployed on Celo. The Contract Addresses page lists both the mainnet contract (0xF6829D7393dAe24509eb1E52eE8e572e2E271a4f) and the testnet contract (0xa188439ccCEe9A6aa0E842f9c17C1b00C7B4dd4D).Celo is an EVM chain, so withdrawals, bridging, and address whitelisting work exactly as they do on the other EVM networks. Resolve its networkId per environment from Get Networks; see the Networks guide.
​
Webhooks

​
Full webhook event coverage

Every documented webhook event is now delivered:
  • On-chain deposits now fire deposit.completed with trx_type: crypto_deposit, carrying both the source-network hash (extl_trx_hash) and the mint hash (base_trx_hash). There is no preceding deposit.received for on-chain deposits.
  • Redemptions now fire redemption.completed when the bank payout settles, and transaction.failed (with reason: "Provider failed to process payout") when it does not. Redeemed cNGN is automatically reverted to your balance on payout failure.
  • The Webhooks guide now documents exact sample payloads for all five events, including the three transaction.failed variants, plus a field-presence matrix.
​
API

​
New endpoint: Bridge Quote

POST /bridge-quote returns the receivable amount, network fee, and bridge fee for a cross-network bridge before you commit to it with POST /bridge. Requires the Swap permission; the request body follows the standard encrypted wire format.
​
Documentation

​
New documentation site

Launch of this documentation site, covering the full third-party API surface: