HomeGuidesAPI Reference
API Reference

Ingest asset data

post
https://example.com/data/assets/ingest

Unified endpoint for ingesting asset data from any source:

  • Manual push from API consumers
  • Adapter subscription callbacks (push mode)
  • Adapter async pull responses

Supports single or batch. Asset identifiers are in the request body.

Body Params
string

Correlation ID from async fetch (202 response)

string

Correlation ID from subscription

string
Defaults to manual

Source identifier. Examples: provider name, "manual".

assets
array of objects
required
length ≥ 1

Array of asset data items (single item or batch)

assets*
identifier
object
required
data
array of objects
required
length ≥ 1
data*
string
required

Category of financial data.

The valid values are not fixed by this specification. A data type is valid if and only if a
JSON schema is published for it as data/{dataType}.schema.json in the FinP2P data schema
registry, which is therefore the authoritative list. A data type with no published schema is
rejected — on ingest, and on data-rule creation — so new categories become available by
publishing a schema, with no specification change and no release.

Currently published, for orientation:

  • assetHeader: Asset catalog metadata (ISIN, CAIP-19 representations, name, icon)
  • pricing: Quotes, NAV, prices
  • referenceData: Asset name, issuer, sector
  • rating: Credit-rating snapshot from a single agency
  • currencyRating: FX-rate snapshot from the asset's currency to target currencies
  • kycRequirements: Per-asset KYC requirements declared by the asset creator
uri

URI to JSON schema for validation of the data object

data
object
required

The actual data payload conforming to the referenced schema

string

Data source identifier

int64

Provider timestamp (epoch milliseconds)

Headers
string

32 bytes buffer (24 randomly generated bytes by the client + 8 bytes epoch timestamp seconds) encoded to hex:

const nonce = Buffer.alloc(32);
nonce.fill(crypto.randomBytes(24), 0, 24);

const nowEpochSeconds = Math.floor(new Date().getTime() / 1000);
const t = BigInt(nowEpochSeconds);
nonce.writeBigInt64BE(t, 24);

Responses

Updated 4 months ago

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 4 months ago