Circle
Connect Circle to the rest of your business, with the right person approving what changes and a record of every action.
21 ways to read, 5 ways to write, each write switched on by you.
Quality checks
Built and tested with example responses.
- Ready to connect: doneEvery listed action is built in.
- Built and tested with example responses: doneEach action is built from the provider’s published API and tested against example responses, errors, rate limits and paging.
Connected, approved, proven.
The things teams do most with Circle, an example flow with a person in the loop, and what Nexra keeps as proof.
Top actions
- Pay out to a bank account
bank_payouts.createApproval by rule - Request a stablecoin payment
payment_intents.createApproval by rule - List balances
balances.listRead
Example flow
- Circle · List balances
balances.listDone - Circle · Pay out to a bank account
bank_payouts.createMaker-checker - Nexra · Record the decision and result in the evidence chainProven
Example workflow. Routine runs go through on their own. Only a change your rules flag, such as one over a limit you set, waits for the right person, who sees the exact change and the rule before it reaches Circle.
What gets logged
- Whether it ran on its own or who approved it, and under which rule
- A fingerprint of the exact request sent to Circle
- Circle's reply: what it created or changed
- One entry in the evidence chain, linked to the one before
Try this in the sandbox
Run the whole flow with test data in your sandbox, then connect a Circle test account before you go live.
For developers
Technical detail
Circle Mint: USDC and EURC balances, on-chain transfers, bank deposits and payouts, payments received, payment intents and conversion rates; governed sends and payouts.
Circle API docs- Source actions
- 21
- Destination actions
- 5
- Data types
- 15
What you can map
Reads are always available. Writes are off until you switch them on for a connection, and governed writes follow your policies.
balances1
- List balancesSource
Available and unsettled USDC and EURC balances, one record per currency.
bank accounts1
- List linked bank accountsSource
Wire bank accounts linked for deposits and payouts. Account numbers and owner details are not returned.
bank payouts3
- Pay out to a bank accountDestinationNot retried automaticallyApproval before production
Redeems USDC or EURC to one of your linked bank accounts. Moves money from your own account: runs when you enable this write on the connection, within any limits you set; asked for outside a published flow, a person approves it first.
- Get bank payoutSource
Read one bank payout by its Circle ID.
- List bank payoutsSourceIncremental
Redemptions of USDC or EURC to your linked bank accounts, with fees and bank reference.
configuration1
- Get account configurationSource
Reads the main (master) wallet ID of the Circle account. Also checks the key.
deposit addresses1
- List deposit addressesSource
Blockchain addresses that pay straight into your Circle wallet.
deposits2
- Get depositSource
Read one deposit by its Circle ID.
- List bank depositsSourceIncremental
Bank wires into Circle that were turned into USDC or EURC (mints).
exchange rates1
- Get exchange rateSource
Circle's indicative (reference) rate between USDC or EURC and a supported currency. Nothing is booked or converted.
exchange settlements1
- List conversion settlementsSourceIncremental
Net amounts payable and receivable for settled currency conversions.
exchange trades2
- Get currency conversionSource
Read one currency conversion by its Circle ID.
- List currency conversionsSourceIncremental
Conversions between stablecoins and local currency, with the rate Circle applied.
payment intents3
- Request a stablecoin paymentDestinationNot retried automaticallyApproval before production
Creates a one-time payment intent and returns the deposit address your customer pays in USDC or EURC. No money moves until they pay.
- Get payment intentSource
Read one payment intent by its Circle ID.
- List payment intentsSourceIncremental
Requests for stablecoin payment (a deposit address per invoice or customer) and how much was paid.
payment refunds1
- Refund a stablecoin paymentDestinationNot retried automaticallyApproval before production
Refunds a settled payment intent to the original sender or another address. Moves money from your own account: runs when you enable this write on the connection, within any limits you set; asked for outside a published flow, a person approves it first.
payments2
- Get paymentSource
Read one payment by its Circle ID.
- List stablecoin payments receivedSourceIncremental
USDC and EURC payments received against your payment intents, and their refunds, with fees and settled amount.
recipient addresses1
- List verified recipient addressesSource
Blockchain addresses approved for sending USDC or EURC.
stablecoin payouts3
- Pay a recipient in stablecoinDestinationNot retried automaticallyApproval before production
Pays USDC or EURC to an active address book recipient. Moves money from your own account: runs when you enable this write on the connection, within any limits you set; asked for outside a published flow, a person approves it first.
- Get stablecoin payoutSource
Read one stablecoin payout by its Circle ID.
- List stablecoin payoutsSourceIncremental
USDC or EURC paid to address book recipients, with Circle and network fees.
transfers3
- Send stablecoin on-chainDestinationNot retried automaticallyApproval before production
Sends USDC or EURC from your Circle wallet to a verified recipient address. Moves money from your own account: runs when you enable this write on the connection, within any limits you set; asked for outside a published flow, a person approves it first.
- Get transferSource
Read one transfer by its Circle ID.
- List on-chain transfersSourceIncremental
Stablecoin transfers into and out of your Circle wallets: incoming deposits from a blockchain address and sends to verified addresses.
Access and limits
- Authentication
- Circle Mint API key
- Plans and access
- A Circle Mint business account with an API key. Payment intents, stablecoin payouts and currency conversions are products Circle enables per account; production keys only reach the APIs your account is approved for.
- Test environment
- Create a free sandbox account at app-sandbox.circle.com and an API key there. Sandbox transactions use test networks and move no real funds.
- Rate limits
- Circle applies per-key limits. HTTP 429 and Retry-After are honoured with bounded retries.
- Pagination
- pageSize up to 50 with from/to time windows; the Link header's next page is followed when Circle sends one.
- Provider events
- Circle Mint sends notifications for deposits, transfers, payouts, payments and payment intents to a subscribed URL Flows run on demand, on a schedule, or when a scheduled check finds new or changed records.
Before you build a flow
- Event triggers: Nexra checks the dated lists (transfers, deposits, payouts, payments, payment intents, conversions) on a schedule you pick; Circle Mint's own notification subscriptions are not used
- Payments run through your own Circle account exactly as you set them up: on-chain sends, bank payouts, stablecoin payouts and refunds run when you enable the write on the connection and publish the flow. Add limits or approval rules if you want, and daily reconciliation shows what moved.
- Payouts and settlements: Circle Mint bank payouts are redemptions to your own bank account; payments received settle straight to your Circle balance.
- Disputes: stablecoin payments have no card-style chargebacks.
- Intentional exclusions: booking currency conversions (FX trades and tradable quotes), creating deposit or recipient addresses, linking bank accounts, address book changes, cross-entity transfers, credit lines and report downloads.
- Bank account numbers, billing names and addresses, and recipient identity details are not returned.
Developer reference
- Create the Circle credentials described above with the narrowest permissions your flows need.
- In Nexra, open Connect, then Connections, then New connection, choose Circle, enter its settings and credentials, and tick only the write actions you need. Connection guide
- Test the connection, then use its actions as flow sources and destinations. Flow guide
Machine-readable detail: GET /api/public/connect/connectors/circle and the Connections API.