---
updatedAt: 2026-06-02T20:06:00.000Z
agentTools:
  projectIndex: https://docs.zerohash.com/llms.txt
---

# Create deposit

This endpoint is used to create a new Fiat deposit and enable instant buying power.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "zerohash API",
    "description": "\n### Authentication\n\nzerohash Uses HMAC SHA-256 verification to ensure the authenticity of API requests, follow instructions by link [https://docs.zerohash.com/reference/api-authentication](https://docs.zerohash.com/reference/api-authentication)\n\n<a href=\"/zh-swagger.json\">Download zerohash OpenAPI Schema as JSON</a>\n",
    "version": "1.7.0"
  },
  "servers": [
    {
      "url": "https://api.cert.zerohash.com",
      "description": "Certification API server"
    }
  ],
  "x-readme": {
    "proxy-enabled": false
  },
  "tags": [
    {
      "name": "Fund",
      "description": "Fund Services"
    }
  ],
  "paths": {
    "/fund/deposit": {
      "post": {
        "tags": [
          "Fund"
        ],
        "summary": "Create deposit",
        "description": "This endpoint is used to create a new Fiat deposit and enable instant buying power.",
        "parameters": [
          {
            "$ref": "#/components/parameters/Signature"
          },
          {
            "$ref": "#/components/parameters/Timestamp"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PostFundDepositRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Successfully created the fiat deposit. Returns the submitted transaction details including its current status.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PostFundDepositResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Code400"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Code403"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Code404"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Code500"
                }
              }
            }
          },
          "503": {
            "description": "Service Unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Code503"
                }
              }
            }
          }
        }
      }
    }
  },
  "security": [
    {
      "apiKey": [],
      "apiPassphrase": []
    }
  ],
  "components": {
    "securitySchemes": {
      "apiKey": {
        "type": "apiKey",
        "description": "Your API public key. See the [Authentication guide](https://docs.zerohash.com/reference/api-authentication) for how to obtain keys.",
        "in": "header",
        "name": "X-SCX-API-KEY"
      },
      "apiPassphrase": {
        "type": "apiKey",
        "description": "The passphrase associated with your API key, set when the key was created.",
        "in": "header",
        "name": "X-SCX-PASSPHRASE"
      }
    },
    "parameters": {
      "Signature": {
        "name": "X-SCX-SIGNED",
        "in": "header",
        "description": "HMAC-SHA256 signature of the request, base64-encoded. See the [Authentication guide](https://docs.zerohash.com/reference/api-authentication) for the exact signing formula.",
        "required": true,
        "schema": {
          "type": "string"
        }
      },
      "Timestamp": {
        "name": "X-SCX-TIMESTAMP",
        "in": "header",
        "description": "Current Unix timestamp in seconds. Must be within 60 seconds of server time or the request is rejected.",
        "required": true,
        "schema": {
          "type": "string",
          "example": "1678901234"
        }
      }
    },
    "schemas": {
      "Code400": {
        "type": "object",
        "description": "Request was rejected by validation or a downstream service. `errors` is an array of human-readable messages; each entry describes a single validation failure or business-rule violation.",
        "required": [
          "errors"
        ],
        "properties": {
          "errors": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "body/amount must be >= 0",
              "body/asset is required"
            ]
          }
        }
      },
      "Code403": {
        "type": "object",
        "description": "Authentication or authorization failed. `error` is always `true`; `message` explains which check failed (missing API key, bad signature, insufficient permission, etc.).",
        "required": [
          "error",
          "message"
        ],
        "properties": {
          "error": {
            "type": "boolean",
            "example": true
          },
          "message": {
            "type": "string",
            "example": "This api key does not have write permission to this endpoint"
          }
        }
      },
      "Code404": {
        "type": "object",
        "description": "The requested resource does not exist or is not visible to the caller.",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "string",
            "example": "Not Found"
          }
        }
      },
      "Code500": {
        "type": "object",
        "description": "An unexpected error occurred on the server. The request can be retried after a short delay, but the same inputs may reproduce the error.",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "string",
            "example": "Internal Server Error"
          }
        }
      },
      "Code503": {
        "type": "object",
        "description": "A downstream dependency was unavailable, timed out, or returned a retryable error. Safe to retry; the response carries an `x-zh-allowretry: true` header. Every error response also carries an `x-zh-errorcode` header with a machine-readable error code (`unknown` when the failing service does not supply one).",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "string",
            "example": "Service Unavailable"
          }
        }
      },
      "PostFundDepositRequest": {
        "type": "object",
        "properties": {
          "participant_code": {
            "type": "string",
            "minLength": 6,
            "maxLength": 6,
            "description": "The participant code tied to the deposit",
            "example": "ABCDEF"
          },
          "external_account_id": {
            "type": "string",
            "description": "The external account id tied to the deposit",
            "example": "0f34533e-2114-469d-b505-c850d776e061"
          },
          "asset": {
            "type": "string",
            "description": "The asset code for the deposit, e.g. USD",
            "example": "USD",
            "enum": [
              "USD"
            ]
          },
          "amount": {
            "type": "string",
            "description": "The amount of the deposit",
            "example": "100"
          },
          "description": {
            "type": "string",
            "description": "Description of the deposit",
            "example": "Deposit for trading account"
          },
          "network": {
            "type": "string",
            "description": "The network for the deposit, e.g. `ach`.",
            "example": "ach",
            "enum": [
              "ach"
            ]
          },
          "instant": {
            "type": "boolean",
            "description": "Whether the deposit should be processed instantly",
            "example": true
          }
        },
        "required": [
          "participant_code",
          "external_account_id",
          "asset",
          "amount",
          "description",
          "network",
          "instant"
        ]
      },
      "PostFundDepositResponse": {
        "type": "object",
        "properties": {
          "request_id": {
            "type": "string",
            "format": "uuid",
            "description": "The request id associated with this deposit submission. Echoes the X-Request-Id header when supplied by the client.",
            "example": "d39b1957-d0cc-40d7-9daf-9a31e9584c5f"
          },
          "transaction_id": {
            "type": "string",
            "format": "uuid",
            "description": "zerohash-generated unique identifier for the deposit.",
            "example": "bfa45e86-d414-4dda-863a-42bbdd7f389e"
          },
          "external_account_id": {
            "type": "string",
            "description": "The external (bank) account identifier debited for this deposit.",
            "example": "487e49ac-c797-4136-8675-9464fc5e8a12"
          },
          "trade_id": {
            "type": "string",
            "description": "Associated trade identifier. Empty string when no conversion trade was created (e.g. USD deposits).",
            "example": ""
          },
          "description": {
            "type": "string",
            "description": "Description of the deposit as supplied on the request.",
            "example": "Deposit for trading account"
          },
          "amount": {
            "type": "string",
            "description": "The amount of the deposit.",
            "example": "5000"
          },
          "status": {
            "type": "string",
            "description": "Current status of the deposit.",
            "example": "submitted",
            "enum": [
              "posted",
              "cancelled",
              "failed",
              "returned",
              "submitted",
              "pending",
              "settled",
              "rejected",
              "returned_settled",
              "retried",
              "unspecified"
            ]
          },
          "transfer_type": {
            "type": "string",
            "description": "Fiat transfer direction for this transaction.",
            "enum": [
              "debit",
              "credit"
            ],
            "example": "debit"
          },
          "network": {
            "type": "string",
            "description": "The network used to process the deposit.",
            "example": "ach",
            "enum": [
              "ach"
            ]
          },
          "participant_code": {
            "type": "string",
            "minLength": 6,
            "maxLength": 6,
            "description": "The participant code credited by this deposit.",
            "example": "ABCDEF"
          },
          "account_label": {
            "type": "string",
            "description": "The account label credited by this deposit. Always 'general' for fund deposits.",
            "example": "general"
          },
          "currency": {
            "type": "string",
            "description": "The fiat currency of the deposit.",
            "example": "USD",
            "enum": [
              "USD"
            ]
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "ISO-8601 timestamp indicating when the deposit was created.",
            "example": "2026-05-04T11:58:45.221Z"
          },
          "ach_agreement_acceptance": {
            "type": "object",
            "description": "Recorded ACH agreement acceptance for this deposit. Present only when an ACH agreement acceptance was recorded with the submission.",
            "properties": {
              "timestamp": {
                "type": "number",
                "description": "Unix timestamp in milliseconds indicating when the ACH agreement was accepted.",
                "example": 1708631671631
              },
              "version": {
                "type": "string",
                "description": "Version of the ACH agreement that was accepted.",
                "example": "1.0.0"
              }
            }
          }
        }
      }
    }
  }
}
```