Install Jentic One Beta

Connect the PinkWallet API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the PinkWallet API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fpinkwallet.com%2Fpinkwallet" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fpinkwallet.com%2Fpinkwallet" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with PinkWallet API.

Generate a shareable payment link that collects a USDT or USDC payment on-chain, with a reference and expires_in

List payment links by status such as pending, paid, expired, or cancelled, and cancel an open link

Quote a conversion between assets and execute it against the quote_id

Quote and place a buy order for an asset paid in fiat

GET STARTED

Start building with PinkWallet API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use PinkWallet API for, with concrete tasks.

★ Invoicing agent collecting stablecoin payments through Jentic

An AI agent sending invoices can attach a pay-by-link option for clients who settle in stablecoins. Through Jentic the agent searches for 'create a stablecoin payment link', loads the PinkWallet createPaymentLink operation with its input schema, and submits an amount as a decimal string, an asset of USDT or USDC, and the invoice number as reference. Your pk_live_ key is injected at call time by your own Jentic One instance.

Call POST /payment_links with amount '250.00', asset 'USDC', reference 'INV-1042', and an Idempotency-Key header, then return the link; later call GET /payment_links/{id} to check whether its status is paid

Treasury conversion between assets

A business holding several currencies converts between them when a payout is due. PinkWallet issues a quote with the rate, amounts, and expiry, and the conversion operation executes it against the quote_id. An Idempotency-Key header makes the write safely retryable for 24 hours.

Call POST /convert/quotes with from_asset 'USDT', to_asset 'USDC', and from_amount '1000.00', then POST /convert with the returned quote_id and an Idempotency-Key

Reconciliation of balances and transactions

Finance teams reconcile what arrived against what they expected. The API lists accounts filtered by currency, balances filtered by asset, and transactions filtered by type, paged with limit and starting_after, so an agent can match paid payment links to deposits.

Call GET /transactions with type 'payment' and limit 50, then GET /payment_links with status 'paid' and match each link to its transaction

Key Endpoints

16 endpoints — the pinkwallet api collects stablecoin payments, holds multi-currency balances, and converts between assets on the same rails as the pinkwallet app.

METHOD

PATH

DESCRIPTION

POST

/payment_links

Create a payment link

GET

/payment_links/{id}

Retrieve a payment link

POST

/payment_links/{id}/cancel

Cancel a payment link

POST

/convert/quotes

Create a conversion quote

POST

/convert

Create a conversion

POST

/buy_orders

Create a buy order

GET

/balances

List balances

GET

/transactions

List transactions

POST

/payment_links

Create a payment link

GET

/payment_links/{id}

Retrieve a payment link

POST

/payment_links/{id}/cancel

Cancel a payment link

POST

/convert/quotes

Create a conversion quote

POST

/convert

Create a conversion

POST

/buy_orders

Create a buy order

GET

/balances

List balances

GET

/transactions

List transactions

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring PinkWallet by hand means sending a pk_live_ or pk_test_ key as a bearer token, choosing between the production and sandbox hosts, HMAC-signing writes with X-PW-Signature, and adding an Idempotency-Key to payment link, conversion, and buy order writes. Through Jentic you install once, import PinkWallet from the API Directory, store the key once, and your agent calls it.

Permission scoping

PinkWallet puts the payment link id in the URL path (/payment_links/{id}/cancel), so a rule can pin your agent to one link, while conversion and buy order amounts travel in the request body. You choose the operations it may call, so fund-moving ones like POST /convert or POST /buy_orders are not included unless you add them.

Credential isolation

Your PinkWallet 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.

Intent-based discovery

Agents search Jentic by intent such as 'create a stablecoin payment link' or 'convert USDT to USDC', and Jentic returns the matching PinkWallet operation with its input schema so the agent sends decimal-string amounts and the right asset codes without browsing the reference docs.

FAQs

Specific to using PinkWallet API through Jentic.

What authentication does the PinkWallet API use?

The PinkWallet API authenticates with your secret API key passed as an HTTP bearer token (bearerAuth) per its OpenAPI spec, with pk_live_ keys for production and pk_test_ keys for the sandbox host. The scheme description adds that write operations are additionally HMAC-signed via an X-PW-Signature header. Through Jentic the key is stored by your own instance and attached at call time.

Can I collect USDC with a payment link using the PinkWallet API?

Yes. POST /payment_links takes an amount as a decimal string and an asset of USDT or USDC, plus an optional reference, expires_in in seconds, and metadata. It returns a shareable link that collects the payment on-chain, and GET /payment_links/{id} shows whether it is pending, paid, expired, or cancelled.

What are the rate limits for the PinkWallet API?

The OpenAPI spec does not specify rate limits. Check the PinkWallet developer site at https://api.pinkwallet.com for current limits; writes accept an Idempotency-Key header so retries after a throttled request do not duplicate a payment link, conversion, or buy order.

Is there a PinkWallet MCP server?

You don't need an MCP server to give your agent PinkWallet. Jentic connects it directly from the API Directory: import it, store your key once, and your agent calls the payment link, conversion, and balance operations on demand without loading another server's tool definitions into its context.

How do I create a payment link through Jentic?

Search Jentic for 'create a stablecoin payment link', load the POST /payment_links operation, and execute it with amount and asset, adding a reference to tie it to an invoice. Use the sandbox host with a pk_test_ key while testing. 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 the PinkWallet API?

Yes. Write a rule that allows only POST /payment_links, GET /payment_links/{id}, and GET /balances, and the agent can request payments and check balances while conversions and buy orders, which move your funds, stay outside its allowed set. Every call it makes is logged for review.

PinkWallet API

AI ReadinessAI-Aware (B-)62/100

See full scorecard

Official vendor OpenAPI document · agent-readyPaymentsPayment Processingbearer16 EndpointsREST

For Agents

Create USDT and USDC payment links, quote and run asset conversions, buy assets with fiat, and read PinkWallet accounts, balances, and transactions.

Use for: Create a payment link for 250.00 USDC, Check whether the invoice payment link has been paid, Cancel the payment link I sent yesterday, Get a quote to convert USDT to USDC

Not supported: Does not process card payments, run recurring subscriptions, or place exchange trades. Use for stablecoin payment links, multi-currency balances, conversions, and buy orders only.

The PinkWallet API collects stablecoin payments, holds multi-currency balances, and converts between assets on the same rails as the PinkWallet app. It generates shareable payment links that collect USDT or USDC on-chain, quotes and executes conversions between assets, and quotes and places orders to buy an asset with fiat. Accounts, balances, and a transaction history of deposits, payouts, conversions, and payments are readable, with all amounts as decimal strings and all timestamps in ISO-8601 UTC.

Jentic One on Github View OpenAPI Document

Show dimension breakdown

Foundational Compliance

Base layer of spec validity and structural soundness.

Grade: A+Signals: 4

98%

Lint Results

Aggregated quality score from linter diagnostics, weighted by severity.

100%

Resolution Completeness

Percentage of `$ref` references that resolve successfully.

100%

Specification Validity

Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).

75%

Structural Integrity

Structural correctness score based on schema issues using logarithmic dampening.

Developer Experience & Jentic Compatibility

Clarity, completeness, and ingestion readiness for developers and tooling.

Grade: C+Signals: 4

Example Density

How richly the API is illustrated with examples.

100%

Example Validity

Percentage of examples that conform to their schemas.

34%

Response Coverage

Percentage of operations with complete response definitions (success, client error, server error).

100%

Tooling Readiness

Health of API ingestion, bundling, and resolution within Jentic pipelines.

AI-Readiness & Agent Experience

Semantic breadth, depth, and agent comprehension for AI systems.

Grade: DSignals: 4

23%

Description Coverage

Coverage of descriptions across API elements.

Error Standardization

Coverage of RFC 9457 Problem Details for error responses.

100%

OperationId Quality

Coverage, uniqueness, and casing consistency of operationIds for AI inference.

53%

Summary Coverage

Coverage of summaries across operations/tags/info.

Agent Usability

Functional utility, complexity comfort, and AI orchestration readiness.

Grade: A+Signals: 1

94%

Complexity Comfort

Agent comfort level based on API operational and structural complexity.

Security

Trust, risk posture, and security compliance.

Grade: B-Signals: 1

60%

Authentication Strength

Average quality of security schemes based on authentication method strength (weakest link for OAuth2).

AI Discoverability

Findability, semantic richness, and reasoning readiness.

Grade: CSignals: 1

55%

Descriptive Richness

Clarity and depth of descriptions across API elements.

Connect the PinkWallet API to your agent

Capabilities

Start building with PinkWallet API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs

PinkWallet API

Jentic AI Readiness Score

PinkWallet API

Foundational Compliance

Lint Results

Resolution Completeness

Specification Validity

Structural Integrity

Developer Experience & Jentic Compatibility

Example Density

Example Validity

Response Coverage

Tooling Readiness

AI-Readiness & Agent Experience

Description Coverage

Error Standardization

OperationId Quality

Summary Coverage

Agent Usability

Complexity Comfort

Security

Authentication Strength

AI Discoverability

Descriptive Richness