Contracts

Create contract

Add a blockchain contract to monitor.

post/v0/contracts

Request

  • Base URL: https://api.formo.so
  • URL: https://api.formo.so/v0/contracts
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Optional unique value (e.g. a UUID v4) that lets you safely retry POST/PUT/PATCH/DELETE requests. The first request runs normally; subsequent requests with the same key replay the stored response (status + body) for 24 hours, so retries can never double-create or double-charge. Two concurrent requests with the same key return 409 IDEMPOTENCY_IN_PROGRESS. Generate a fresh key per logical operation.

Request body

addressstring required

EVM contract address

chaininteger required

Chain ID

namestring required
abistring required

JSON-stringified ABI

start_blockinteger

Block height recorded on the contract. Note: the events pipeline currently opens every source at the chain head, so this does not backfill historical events. Defaults to 0.

include_in_pipelineboolean

Whether to include this contract in the project contract-events pipeline. When false the ABI is still cached for transaction decoding, but no events are indexed. Defaults to false (decode-only).

Response

Contract created

namestring required
chaininteger required
addressstring required
start_blockinteger
abistring required
include_in_pipelineboolean required

Whether the contract is configured for the project contract-events pipeline. This is the desired membership, not live deployment state: use the deploy sidecar on the contract list to see what is currently deployed.

Changes

No recorded changes to this operation across all 1 revision of this API.