Fin Virtual Accounts API
Create and manage virtual accounts for USD to USDC conversions
Create and manage virtual accounts for USD to USDC conversions
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/fin:fin-virtual-accounts-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Fin.com Virtual Accounts API
version: 1.0.0
description: A simple API specification
servers:
- url: https://sandbox.api.fin.com
description: Sandbox server
- url: https://api.fin.com
description: Production server
tags:
- name: Virtual Accounts
description: Create and manage virtual accounts for USD to USDC conversions
paths:
/v1/customers/virtual-account:
post:
summary: Create Virtual Account
description: Create a virtual bank account for a customer to convert USD deposits to USDC on Polygon
tags:
- Virtual Accounts
security:
- bearerAuth: []
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- customer_id
- destination_currency
- destination_chain
- source_rail
- source_currency
- destination_wallet_address
- developer_fee_percentage
properties:
customer_id:
type: string
format: uuid
description: Unique identifier for the customer
example: 5a6f47f7-7326-409f-a4da-90e409133fb8
destination_currency:
type: string
enum:
- USDC
default: USDC
description: Destination cryptocurrency
destination_chain:
type: string
enum:
- POLYGON
default: POLYGON
description: Blockchain network for destination
source_rail:
type: string
description: Payment rail for deposits
example: ACH
source_currency:
type: string
description: Source currency code
example: USD
destination_wallet_address:
type: string
description: Destination wallet address in hexadecimal format (0x...)
example: '0x7f1568190e318da16a9ef5a46cba19d5b97d9b29'
developer_fee_percentage:
type: number
description: Developer fee percentage
example: 1.5
examples:
New Example:
summary: New Example
value:
customer_id: 5a6f47f7-7326-409f-a4da-90e409133fb8
destination_currency: USDC
destination_chain: POLYGON
source_rail: ACH
source_currency: USD
destination_wallet_address: '0x7f1568190e318da16a9ef5a46cba19d5b97d9b29'
developer_fee_percentage: 1.5
responses:
'200':
description: Virtual account created successfully
content:
application/json:
schema:
type: object
required:
- data
properties:
data:
type: object
required:
- id
- status
- developer_fee_percent
- customer_id
- created_at
- updated_at
- deposit_instructions
- destination
properties:
id:
type: string
format: uuid
description: Unique identifier for the virtual account
example: eb99dce4-d26d-442a-9873-47336e9936ca
status:
type: string
description: Status of the virtual account
example: ACTIVE
developer_fee_percent:
type: number
description: The developer fee percentage set when creating the virtual account
example: 1.5
customer_id:
type: string
format: uuid
description: Customer identifier
example: 5a6f47f7-7326-409f-a4da-90e409133fb8
created_at:
type: string
format: date-time
description: Timestamp when the account was created in ISO 8601 format
example: '2025-12-17T10:57:19.113092Z'
updated_at:
type: string
format: date-time
description: Timestamp when the account was last updated in ISO 8601 format
example: '2025-12-17T10:57:19.113092Z'
deposit_instructions:
type: object
required:
- currency
- bank_name
- bank_address
- bank_routing_number
- bank_account_number
- bank_beneficiary_name
- bank_beneficiary_address
- payment_rails
properties:
currency:
type: string
example: USD
bank_name:
type: string
example: Bank of Nowhere
bank_address:
type: string
example: 1800 North Pole St., Orlando, FL 32801
bank_routing_number:
type: string
example: '101019644'
bank_account_number:
type: string
example: '900801702004'
bank_beneficiary_name:
type: string
example: Stageusa Testva
bank_beneficiary_address:
type: string
example: 1200 Pennsylvania Avenue NW, Georgia, GA 20500, US
payment_rails:
type: array
items:
type: string
example:
- ACH
- FEDWIRE
destination:
type: object
required:
- currency
- destination_chain
- address
properties:
currency:
type: string
enum:
- USDC
default: USDC
description: Destination cryptocurrency
destination_chain:
type: string
enum:
- POLYGON
default: POLYGON
description: Blockchain network
address:
type: string
description: The destination wallet address in hexadecimal format (0x...)
example: '0x7f1568190e318da16a9ef5a46cba19d5b97d9b29'
examples:
OK:
summary: OK
value:
data:
id: eb99dce4-d26d-442a-9873-47336e9936ca
status: ACTIVE
developer_fee_percent: 1.5
customer_id: 5a6f47f7-7326-409f-a4da-90e409133fb8
created_at: '2025-12-17T10:57:19.113092Z'
updated_at: '2025-12-17T10:57:19.113092Z'
deposit_instructions:
currency: USD
bank_name: Bank of Nowhere
bank_address: 1800 North Pole St., Orlando, FL 32801
bank_routing_number: '101019644'
bank_account_number: '900801702004'
bank_beneficiary_name: Stageusa Testva
bank_beneficiary_address: 1200 Pennsylvania Avenue NW, Georgia, GA 20500, US
payment_rails:
- ACH
- FEDWIRE
destination:
currency: USDC
destination_chain: POLYGON
address: '0x7f1568190e318da16a9ef5a46cba19d5b97d9b29'
'401':
$ref: '#/components/responses/AuthenticationError'
'422':
$ref: '#/components/responses/ValidationError'
operationId: postV1CustomersVirtualAccount
x-operation-id-source: derived
components:
responses:
ValidationError:
description: Failed due to a formatting error.
content:
application/json:
schema:
type: object
required:
- message
properties:
message:
type: string
description: An error message describing what went wrong.
errors:
type: array
items:
type: object
additionalProperties:
type: string
example: Appropriate client_secret required.
AuthenticationError:
description: Authentication failed due to invalid credentials
content:
application/json:
schema:
type: object
properties:
message:
type: string
description: The error message
example: Authentication failed
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: Bearer token authentication. Obtain token from /v1/oauth/token endpoint
x-provenance:
method: harvested
publisher: Fin
source: https://developer.fin.com/openapi.yaml
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)