Model API/CLASSIFIERS

Financial Sentiment

Classify the financial sentiment of text.

POST/api/models/sentiment

Authorizations

Bearer
Authorizationstringrequiredheader

Required Bearer API key. Programmatic access to the World API needs a key; browsing nosible.world in a browser does not.

Example: Bearer nos_sk_...

Body

application/json
textstringrequiredbody

Financial text to classify. Maximum 50,000 characters.

Example: Revenue growth accelerated this quarter.

Related in NOSIBLE World

World · Map ↗Open this result set on the event map, filtered to the same windowWorld · Trend ↗Plot the same query as a historical event signalWorld · Chaos ↗Watch the unfiltered crawl the ontology is built from

How to use this endpoint

guidance

Use Financial Sentiment for a model-backed financial tone classification. The endpoint accepts the same text-only request and response shape as the other model endpoints.

Response body

application/json

These are the fields you can build against. Nested names use dot notation; optional sections are called out in their descriptions.

schemastring

Stable classifier response schema shared by all four model endpoints.

Example: nosible_model_classification_v1

modelstring

Pinned classifier name, version, and immutable build identifier.

Example: NOSIBLE/financial-sentiment-v1.2-base@revision:acc796e59f4b568fe73e127de81c10a982b88845

textstring

The exact input text classified by the model.

Example: Revenue growth accelerated this quarter.

predictionsobject[]

The classifier output as a one-item prediction list.

Example: [{ "label": "positive", "score": 0.90 }]

predictions[].labelenum

One of positive, neutral, or negative.

Example: positive

predictions[].scorenumber

Model confidence score when supplied by the classifier.

Example: 0.90

Responses and errors

HTTP
200Request succeeded. The response body is shown in the panel on the right.
400invalid_request — The request is syntactically valid JSON but a value, date, filter, or combination of fields is invalid.
401unauthorized — The required API key or Bearer credential is missing or invalid.
422validation_error — The request shape is understood but one or more values fail validation.
429rate_limited — The request exceeded the account or public-window rate limit. Respect Retry-After when supplied.
502upstream_error — An upstream retrieval service failed while processing the request.
504upstream_timeout — An upstream retrieval service did not respond within the request timeout.