B3 wallets API
The wallets API from B3 — 4 operation(s) for wallets.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/b3-wallets-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: B3 Wallets API
version: '1.0'
description: 'Operations tagged wallets across 2 of this provider''s published API definitions: b3-b3os-workflow-openapi.json, b3-b3os-workflow-openapi_2.json. Each path carries the servers of the definition it was published in.'
tags:
- name: Wallets
paths:
/v1/organizations/{orgId}/wallets:
get:
description: List all wallets for an organization with pagination
parameters:
- description: Organization ID
in: path
name: orgId
required: true
schema:
type: string
- description: Limit (default 20, max 100)
in: query
name: limit
schema:
type: integer
- description: Offset (default 0)
in: query
name: offset
schema:
type: integer
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/ListWalletsSuccessResponse'
description: OK
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
description: Bad Request
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
description: Unauthorized
'500':
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
description: Internal Server Error
tags:
- Wallets
summary: Get organizations by org id wallets
x-summary-source: derived
operationId: getV1OrganizationsByOrgIdWallets
x-operation-id-source: derived
post:
description: Create a new Turnkey wallet for an organization
parameters:
- description: Organization ID
in: path
name: orgId
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
oneOf:
- type: object
- $ref: '#/components/schemas/CreateWalletParams'
summary: request
description: Wallet name
description: Wallet name
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/WalletResponse'
description: OK
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
description: Bad Request
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
description: Unauthorized
'500':
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
description: Internal Server Error
tags:
- Wallets
summary: Create organizations by org id wallets
x-summary-source: derived
operationId: postV1OrganizationsByOrgIdWallets
x-operation-id-source: derived
/v1/organizations/{orgId}/wallets/{walletId}:
delete:
description: Archive a wallet (soft delete). Cannot archive default wallet or only wallet.
parameters:
- description: Organization ID
in: path
name: orgId
required: true
schema:
type: string
- description: Wallet ID
in: path
name: walletId
required: true
schema:
type: string
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_service_wallet.ArchiveWalletResponse'
description: OK
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
description: Bad Request
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
description: Unauthorized
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
description: Not Found
'500':
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
description: Internal Server Error
tags:
- Wallets
summary: Delete organizations by org id wallets by wallet id
x-summary-source: derived
operationId: deleteV1OrganizationsByOrgIdWalletsByWalletId
x-operation-id-source: derived
patch:
description: 'Rename an organization wallet''s user-facing label. The wallet''s
on-chain address and Turnkey identifiers are unchanged.'
parameters:
- description: Organization ID
in: path
name: orgId
required: true
schema:
type: string
- description: Wallet ID
in: path
name: walletId
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
oneOf:
- type: object
- $ref: '#/components/schemas/RenameWalletParams'
summary: request
description: Rename parameters
description: Rename parameters
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_pkg_entity.OrganizationWallet_2'
description: OK
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
description: Bad Request
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
description: Unauthorized
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
description: Not Found
'409':
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
description: Conflict
'500':
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
description: Internal Server Error
tags:
- Wallets
summary: Update organizations by org id wallets by wallet id
x-summary-source: derived
operationId: patchV1OrganizationsByOrgIdWalletsByWalletId
x-operation-id-source: derived
/v1/organizations/{orgId}/wallets/{walletId}/default:
put:
description: Set a wallet as the default wallet for an organization.
parameters:
- description: Organization ID
in: path
name: orgId
required: true
schema:
type: string
- description: Wallet ID
in: path
name: walletId
required: true
schema:
type: string
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_pkg_entity.OrganizationWallet'
description: OK
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
description: Bad Request
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
description: Unauthorized
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
description: Not Found
'500':
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
description: Internal Server Error
tags:
- Wallets
summary: Replace organizations by org id wallets by wallet id default
x-summary-source: derived
operationId: putV1OrganizationsByOrgIdWalletsByWalletIdDefault
x-operation-id-source: derived
/v1/organizations/{orgId}/wallets/{walletId}/withdraw:
post:
description: Withdraw tokens from an organization wallet via Turnkey signing
parameters:
- description: Organization ID
in: path
name: orgId
required: true
schema:
type: string
- description: Wallet ID
in: path
name: walletId
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
oneOf:
- type: object
- $ref: '#/components/schemas/WithdrawWalletParams'
summary: request
description: Withdraw parameters
description: Withdraw parameters
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/WithdrawWalletResponse'
description: OK
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
description: Bad Request
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
description: Unauthorized
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
description: Not Found
'502':
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
description: Bad Gateway
tags:
- Wallets
summary: Create organizations by org id wallets by wallet id withdraw
x-summary-source: derived
operationId: postV1OrganizationsByOrgIdWalletsByWalletIdWithdraw
x-operation-id-source: derived
/v1/organizations/{orgId}/wallets/import:
post:
description: Register an imported Turnkey private key wallet for an organization
parameters:
- description: Organization ID
in: path
name: orgId
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
oneOf:
- type: object
- $ref: '#/components/schemas/ImportWalletParams'
summary: request
description: Import wallet params
description: Import wallet params
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/WalletResponse_2'
description: OK
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
description: Bad Request
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
description: Unauthorized
'409':
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
description: Conflict
'500':
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
description: Internal Server Error
tags:
- Wallets
summary: Create organizations by org id wallets import
x-summary-source: derived
operationId: postV1OrganizationsByOrgIdWalletsImport
x-operation-id-source: derived
/v1/organizations/{orgId}/wallets/polymarket-deposit:
post:
description: Create a Polymarket deposit wallet for an organization
parameters:
- description: Organization ID
in: path
name: orgId
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
type: object
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/SetupDepositWalletResponse'
description: OK
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
description: Bad Request
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
description: Unauthorized
'500':
content:
application/json:
schema:
$ref: '#/components/schemas/github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse'
description: Internal Server Error
tags:
- Wallets
summary: Create organizations by org id wallets polymarket deposit
x-summary-source: derived
operationId: postV1OrganizationsByOrgIdWalletsPolymarketDeposit
x-operation-id-source: derived
components:
schemas:
PaginatedData-schemas_WalletResponse:
properties:
hasMore:
type: boolean
items:
items:
$ref: '#/components/schemas/WalletResponse'
type: array
uniqueItems: false
limit:
type: integer
offset:
type: integer
type: object
github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_service_wallet.ArchiveWalletResponse:
properties:
archivedWorkflowIds:
items:
type: string
type: array
uniqueItems: false
message:
type: string
type: object
CreateWalletParams:
properties:
name:
maxLength: 100
type: string
required:
- name
type: object
WithdrawWalletParams:
properties:
amount:
type: string
chainId:
minimum: 1
type: integer
recipientAddress:
type: string
tokenAddress:
type: string
required:
- amount
- chainId
- recipientAddress
- tokenAddress
type: object
WalletResponse:
properties:
address:
type: string
createdAt:
type: integer
id:
type: string
isDefault:
type: boolean
name:
type: string
organizationId:
type: string
turnkeySubOrgId:
type: string
turnkeyWalletId:
type: string
updatedAt:
type: integer
type: object
github_com_b3-fun_b3-mono_services_b3os-workflow_internal_pkg_entity.OrganizationWallet:
properties:
address:
type: string
createdAt:
type: string
deletedAt:
type: string
deletedBy:
type: string
id:
type: string
isDefault:
type: boolean
name:
type: string
organizationId:
type: string
turnkeyWalletId:
type: string
updatedAt:
type: string
type: object
WithdrawWalletResponse:
properties:
blockNumber:
type: integer
transactionHash:
type: string
type: object
ListWalletsSuccessResponse:
properties:
code:
example: 200
type: integer
data:
$ref: '#/components/schemas/PaginatedData-schemas_WalletResponse'
message:
example: success
type: string
requestId:
example: abc-123
type: string
type: object
github_com_b3-fun_b3-mono_services_b3os-workflow_internal_app_api_http.ErrorResponse:
properties:
code:
type: integer
details:
items: {}
type: array
uniqueItems: false
message:
type: string
requestId:
type: string
type: object
CreateWalletParams_2:
properties:
accounts:
items:
$ref: '#/components/schemas/WalletAccountParams'
type: array
uniqueItems: false
name:
maxLength: 100
type: string
required:
- name
type: object
ImportWalletParams:
properties:
address:
type: string
name:
maxLength: 100
type: string
turnkeyPrivateKeyId:
type: string
required:
- address
- name
- turnkeyPrivateKeyId
type: object
WalletResponse_2:
properties:
accountType:
type: string
address:
type: string
createdAt:
type: integer
id:
type: string
isDefault:
type: boolean
isImported:
type: boolean
name:
type: string
organizationId:
type: string
providerType:
type: string
providerWalletId:
type: string
turnkeyRootUserId:
description: 'TurnkeyRootUserId is an internal Turnkey infrastructure ID.
Only populated for the import-wallet flow; do not rely on it in other consumers.'
type: string
turnkeySubOrgId:
type: string
updatedAt:
type: integer
type: object
github_com_b3-fun_b3-mono_services_b3os-workflow_internal_pkg_entity.OrganizationWallet_2:
properties:
accountType:
type: string
address:
type: string
createdAt:
type: string
deletedAt:
type: string
deletedBy:
type: string
id:
type: string
isDefault:
type: boolean
isImported:
type: boolean
name:
type: string
organizationId:
type: string
providerConfig:
additionalProperties: {}
type: object
providerType:
type: string
providerWalletId:
type: string
updatedAt:
type: string
type: object
RenameWalletParams:
properties:
name:
maxLength: 100
type: string
required:
- name
type: object
WalletAccountParams:
properties:
addressFormat:
enum:
- ADDRESS_FORMAT_ETHEREUM
- ADDRESS_FORMAT_SOLANA
type: string
curve:
enum:
- CURVE_SECP256K1
- CURVE_ED25519
type: string
path:
type: string
pathFormat:
enum:
- PATH_FORMAT_BIP32
type: string
required:
- addressFormat
- curve
- path
- pathFormat
type: object
SetupDepositWalletResponse:
properties:
depositWalletAddress:
type: string
walletId:
type: string
type: object
x-refined-from:
- b3-b3os-workflow-openapi.json
- b3-b3os-workflow-openapi_2.json