Skip to main content
POST
Error

Authorizations

Authorization
string
header
required

API token generated from the Goldsky Dashboard. Pass as: Authorization: Bearer

Path Parameters

theme
string
required

The feed's theme, e.g. wallets.

dataset
string
required

The feed's dataset, e.g. balances or transfers.

Body

application/json
secret_name
string
required

The project's Postgres secret for the database holding it.

Minimum string length: 1
schema
string

Its schema: lowercase, not a Postgres keyword. Defaults to public.

Maximum string length: 63
Pattern: ^[a-z_][a-z0-9_]*$
table
string

The table: lowercase, not a Postgres keyword.

Maximum string length: 63
Pattern: ^[a-z_][a-z0-9_]*$
address_column
string

The column holding the wallet addresses. EVM addresses must be lowercase.

Maximum string length: 63
Pattern: ^[A-Za-z_][A-Za-z0-9_]*$
updated_at_column
string

A timestamp or timestamptz column set whenever a row is added or changed.

Maximum string length: 63
Pattern: ^[A-Za-z_][A-Za-z0-9_]*$

Response

200 - application/json

Default Response

tables
object[]
required

The database's tables, at most 1000.

columns
object[] | null
required

table's columns, when table is set.

row_count
integer | null
required

table's rows, when address_column and updated_at_column are set too.

uppercase_evm_count
integer | null
required

Rows whose address is an EVM address with uppercase hex, which the sync does not match. Set alongside row_count.