THE AGENT
This section provides a downloadable, installable skill for AI coding agents. The skill packages Bullring’s authentication rules, API workflows, webhook contract, safety constraints, and reference links into one agent-readable file.
Download skill.md
For installation instructions, harness-specific setup, and updates, see
Install Bullring agent tools.
Available skills
Authenticate requests
Configure a registered RSA public key and generate request signatures from the exact canonical request bytes. Relevant guides:Create and monitor NGN deposits
Create or retrieve a virtual account, list deposits, retrieve a deposit by ID, and simulate sandbox deposits. Relevant API pages:Manage recipients and withdrawals
Create and retrieve NGN recipients, create withdrawals, and monitor withdrawal status. Relevant API pages:Retrieve conversion quotes
Request an exchange-rate and fee quote before initiating a conversion. Relevant API page:Process webhook notifications
Receive deposit and withdrawal events through Convoy, verifyX-BULLRING-SIGNATURE, deduplicate deliveries, and handle retries safely.
Relevant guides:
Standard workflows
Build a deposit integration
- Register the partner public key in the dashboard.
- Create or retrieve the NGN virtual account.
- Store the account details and display them to the payer.
- Receive and verify deposit webhook notifications.
- Retrieve the deposit by ID when reconciliation requires a fresh status.
Build a withdrawal integration
- Create and validate an NGN recipient.
- Request a withdrawal with an idempotency key.
- Persist the returned withdrawal ID.
- Process status notifications without assuming delivery order.
- Retry only according to the documented error and idempotency rules.
Constraints for agents
- Never expose private keys, webhook secrets, or signature values in logs or source control.
- Sign the exact method, path, headers, and raw body sent over the wire.
- Keep store scope attached to the registered integration.
- Do not use undocumented balance, Lightning deposit, or stablecoin withdrawal routes.
- Treat money values as decimal strings.
- Use sandbox simulation only for testing.
Machine-readable resources
/llms.txt— page index for AI tools./llms-full.txt— complete documentation context./skill.md— generated or custom agent skill./openapi.json— API schema.