Fin

Fin Virtual Accounts API

Create and manage virtual accounts for USD to USDC conversions

GitHub OpenAPI

Operations 1

POST /v1/customers/virtual-account Create Virtual Account #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/fin:fin-virtual-accounts-api"
All apis
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.

Get an API 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 Specification

fin-virtual-accounts-api-openapi.yml Raw ↑
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)