Skip to main content

Chainlink

Validado (off-chain / infra)
Suite misc-infra — price feeds + VRF/consumers validados.

Gerada automaticamente do spec OpenAPI da API (fonte de verdade). 17 endpoint(s).

List price feeds

GET /v1/price_feeds

List Chainlink price feeds available per network

Auth: api-key

Query params:

ParamTipoObrigatório
networkstringnão

Respostas: 200, 401


Get current price

GET /v1/price_feeds/{pair}

Get current price from Chainlink AggregatorV3

Auth: api-key

Path params: pair

Query params:

ParamTipoObrigatório
networkstringnão

Respostas: 200, 401, 404


Get price feed config

GET /v1/price_feeds/{pair}/config

Get price feed consumer contract configuration

Auth: api-key

Path params: pair

Query params:

ParamTipoObrigatório
networkstringnão

Respostas: 200, 401, 404


Update price feed max age

POST /v1/price_feeds/{pair}/max_age

Update max age on price feed consumer contract

Auth: api-key

Path params: pair

Query params:

ParamTipoObrigatório
networkstringnão

Request body:

CampoTipoObrigatórioDescrição
max_age_secondsnumbersimMax age in seconds for stale price detection
idempotency_keystringnãoIdempotency key

Respostas: 200, 201, 401, 404


Update price feed max age (PUT legacy)

PUT /v1/price_feeds/{pair}/max_age

Auth: api-key

Path params: pair

Query params:

ParamTipoObrigatório
networkstringnão

Request body:

CampoTipoObrigatórioDescrição
max_age_secondsnumbersimMax age in seconds for stale price detection
idempotency_keystringnãoIdempotency key

Respostas: 200


Get price rounds

GET /v1/price_feeds/{pair}/rounds

Get historical round data from Chainlink price feed

Auth: api-key

Path params: pair

Query params:

ParamTipoObrigatório
networkstringnão
countnumbernão

Respostas: 200, 401, 404


Deploy price feed consumer

POST /v1/price_feeds/consumers

Deploy a new Chainlink PriceFeed consumer contract via Factory

Auth: api-key

Request body:

CampoTipoObrigatórioDescrição
namestringsimConsumer name for tracking
networkstringsimNetwork for deployment
price_feed_addressstringsimChainlink price feed aggregator address
pairstringsimPrice pair identifier
max_age_secondsnumbernãoMax age in seconds for stale price detection
idempotency_keystringnãoIdempotency key

Respostas: 201, 400, 401


Deploy VRF consumer

POST /v1/vrf/consumers

Deploy a new Chainlink VRF v2.5 consumer contract via Factory

Auth: api-key

Request body:

CampoTipoObrigatórioDescrição
namestringsimConsumer name for tracking
networkstringsimNetwork for deployment
vrf_coordinatorstringsimVRF Coordinator address
key_hashstringsimKey hash for VRF
subscription_idstringsimVRF subscription ID
request_confirmationsnumbernãoNumber of request confirmations (1-200)
callback_gas_limitnumbernãoCallback gas limit (100k-2.5M)
idempotency_keystringnãoIdempotency key

Respostas: 201, 400, 401


Get VRF consumer config

GET /v1/vrf/consumers/{id}/config

Get VRF consumer contract configuration from chain

Auth: api-key

Path params: id

Respostas: 200, 401, 404


Update VRF consumer config

POST /v1/vrf/consumers/{id}/config

Update VRF consumer contract configuration on-chain

Auth: api-key

Path params: id

Request body:

CampoTipoObrigatórioDescrição
key_hashstringnãoKey hash for VRF
subscription_idstringnãoVRF subscription ID
request_confirmationsnumbernãoNumber of request confirmations
callback_gas_limitnumbernãoCallback gas limit
idempotency_keystringnãoIdempotency key

Respostas: 200, 201, 401, 404


Update VRF config (PUT legacy)

PUT /v1/vrf/consumers/{id}/config

Auth: api-key

Path params: id

Request body:

CampoTipoObrigatórioDescrição
key_hashstringnãoKey hash for VRF
subscription_idstringnãoVRF subscription ID
request_confirmationsnumbernãoNumber of request confirmations
callback_gas_limitnumbernãoCallback gas limit
idempotency_keystringnãoIdempotency key

Respostas: 200


Get VRF request ID by index

GET /v1/vrf/consumers/{id}/request_id

Get the on-chain request ID at a given index from the VRF consumer

Auth: api-key

Path params: id

Query params:

ParamTipoObrigatório
indexnumbersim

Respostas: 200, 401


Get VRF requester

GET /v1/vrf/consumers/{id}/requester

Get the address that submitted a VRF request by request ID

Auth: api-key

Path params: id

Query params:

ParamTipoObrigatório
request_idstringsim

Respostas: 200, 401


Notify VRF fulfillment

POST /v1/vrf/fulfillment

Push-based notification for VRF fulfillment. Immediately verifies on-chain and processes the result, bypassing the 30s polling delay.

Auth: api-key

Request body:

CampoTipoObrigatórioDescrição
request_idstringsimVRF request ID

Respostas: 200, 201, 401, 404


Request VRF random words

POST /v1/vrf/requests

Request verifiable random words via Chainlink VRF v2.5

Auth: api-key

Request body:

CampoTipoObrigatórioDescrição
consumer_idstringsimVRF Consumer deployment ID
num_wordsnumbersimNumber of random words to request (1-500)
networkstringsimNetwork for VRF request
idempotency_keystringnãoIdempotency key

Respostas: 201, 400, 401, 404


Get VRF request

GET /v1/vrf/requests/{id}

Get VRF request status and random words

Auth: api-key

Path params: id

Respostas: 200, 401, 404


Get VRF result

GET /v1/vrf/requests/{id}/result

Get random words result from on-chain VRF consumer

Auth: api-key

Path params: id

Respostas: 200, 401, 404